feat: 建立初级维护者文档体系 (#2)

docs/01-workflow.md

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