From af4c1cbdd73cf9f6df971415487e2664e227ebc9 Mon Sep 17 00:00:00 2001
From: ila <ila2002@qq.com>
Date: Sat, 8 Aug 2026 08:57:34 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A2=9E=E5=8A=A0=E9=A3=8E=E9=99=A9?=
 =?UTF-8?q?=E8=BE=B9=E7=95=8C=E4=B8=8E=E6=96=87=E6=A1=A3=E5=BD=B1=E5=93=8D?=
 =?UTF-8?q?=E8=A7=84=E5=88=99=20(#2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Development-Workflow.-.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md
index 2ebb640..f37cf2e 100644
--- a/Development-Workflow.-.md
+++ b/Development-Workflow.-.md
@@ -75,6 +75,44 @@ python scripts/new_task_archive.py 123 "修复登录超时"
 - Wiki 更新成功而导出失败时，在工单记录部分完成状态，不得把任务标为完成。
 - 与具体代码版本强绑定的接口或迁移资料可直接随代码维护，但必须在 Wiki 提供入口或适用版本说明。
 
+## 面向初级维护者的修改边界
+
+| 风险 | 示例 | 处理方式 |
+|---|---|---|
+| 低 | 文案、简单校验、查询条件、独立 UI、小范围回归 Bug | 初级程序员可在 Agent 协助下理解、修改和验证 |
+| 中 | API、配置、依赖、跨模块逻辑、数据结构 | 由 Agent 实现，程序员检查差异并执行验证 |
+| 高 | 权限、安全、并发、迁移、支付、删除数据、不可逆操作 | 停止修改，由 Agent 分析并等待人工确认 |
+
+风险由影响范围决定，不按代码行数判断。
+
+## 每个任务的文档影响
+
+单元任务必须明确选择：
+
+- 不影响长期文档，并说明原因；
+- 更新项目档案或运行验证；
+- 更新架构与代码地图；
+- 更新业务规则与术语；
+- 更新常见修改或故障排查；
+- 新增或调整其他 Wiki 页面。
+
+以下变化必须更新相关 Wiki：
+
+- 启动、测试、部署或排错命令变化；
+- 模块入口、目录职责或主要调用路径变化；
+- 配置项、API、数据结构或状态变化；
+- 业务规则、安全边界或权限变化；
+- 日志位置、错误定位或常见处理方式变化。
+
+普通内部重构如果入口、行为、配置和验证方式均未改变，可以记录“不影响长期文档”及原因。
+
+## 稳定文档与任务归档
+
+- Home、项目档案、代码地图、业务规则、开发验证、常见修改和故障排查描述项目现在怎样工作。
+- 工单和任务归档解释某次为什么修改、实际改了什么以及如何验证。
+- 新人先读稳定主题页，只有追查历史原因时才读任务归档。
+- 任务产生的长期结论必须合并到主题页，不能只留在归档。
+
 ## 什么时候重新确认方案
 
 以下变化必须先更新工单，再由用户确认：