diff --git a/Task-5-Simplify-Agents.-.md b/Task-5-Simplify-Agents.-.md new file mode 100644 index 0000000..98ce7f9 --- /dev/null +++ b/Task-5-Simplify-Agents.-.md @@ -0,0 +1,60 @@ +# 5 精简 AGENTS 中重复的解释性内容 + +- 类型:重构 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 +- 日期:2026-08-08 +- Gitea 工单:[opc/dev_harness#5](http://ilaer.eicp.net:8418/opc/dev_harness/issues/5) +- Wiki 页面:Task-5-Simplify-Agents +- Wiki revision:见本地镜像头 + +## 背景与目标 + +AGENTS 中部分工单层级、风险示例和核心文档说明已经由 Wiki 完整维护。本任务把 AGENTS 精简为强制规则入口,降低重复维护,同时保证 Agent 只读入口规则时不会遗漏安全和交付要求。 + +## 最终方案 + +- 工单层级保留单元任务唯一实施、父工单索引和同步要求,详细定义链接开发工作流与业务术语。 +- 归档步骤压缩但保留待验收、Wiki 优先、镜像检查、独立提交、证据回写和验收关闭。 +- 风险示例表改为强制结论,详细示例链接常见修改指南。 +- 核心文档清单改为更新触发条件,详细清单链接新项目初始化指南。 +- dev_scripts 不与业务脚本混放的项目红线保留。 +- Harness 检查关键强制规则文本,防止后续精简误删。 +- 六个现有 Wiki 页面已经承接详细内容,本任务未修改稳定 Wiki 正文。 + +## 修改文件 + +- `AGENTS.md`:精简重复解释并增加现有镜像入口。 +- `dev_scripts/check_harness.py`:检查关键强制规则仍然存在。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 所有安全和交付强制规则保留 | 通过 | +| 详细层级、风险和文档清单不再重复 | 通过 | +| 被精简内容均有现有文档入口 | 通过 | +| 单元任务仍是唯一实施单位 | 通过 | +| 高风险修改仍需停止和确认 | 通过 | +| 用户验收前不得关闭工单 | 通过 | +| Harness 和测试通过 | 通过 | + +## 测试 + +- AGENTS 非空规则行:115 降至 102。 +- 执行命令:`python -m unittest discover -s tests -v` +- 结果:17/17 通过。 +- 执行命令:`python dev_scripts/check_harness.py --strict` +- 结果:通过。 +- 执行命令:`python dev_scripts/sync_wiki_docs.py --check` +- 结果:14/14 映射一致。 +- 执行命令:`python -m compileall -q dev_scripts tests` +- 结果:通过。 +- 执行命令:`git diff --check` +- 结果:通过。 +- **未验证部分**:无。 + +## 相关提交 + +- `c9f1bc8` refactor: 精简 AGENTS 重复说明 (#5)