2

Task-5-Simplify-Agents

ila edited this page 2026-08-08 11:25:36 +08:00

Table of Contents

• 5 精简 AGENTS 中重复的解释性内容
• 背景与目标
• 最终方案
• 修改文件
• 验收结果
• 测试
• 相关提交

5 精简 AGENTS 中重复的解释性内容

• 类型：重构
• 所属 Epic：无
• 所属 MVP / 版本：无
• 状态：已完成
• 日期：2026-08-08
• Gitea 工单：opc/dev_harness#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：检查关键强制规则仍然存在。

验收结果

用户于 2026-08-08 明确验收通过。

验收标准	结果
所有安全和交付强制规则保留	通过
详细层级、风险和文档清单不再重复	通过
被精简内容均有现有文档入口	通过
单元任务仍是唯一实施单位	通过
高风险修改仍需停止和确认	通过
用户验收前不得关闭工单	通过
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)