69 lines
2.7 KiB
Markdown
69 lines
2.7 KiB
Markdown
|
<!-- gitea-wiki-mirror:start -->
|
||
|
|
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
||
|
|
wiki_page: Task-5-Simplify-Agents
|
||
|
|
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-5-Simplify-Agents.-
|
||
|
|
wiki_revision: 28df4129a9d4d90c42cd24b14a69ab0bcbd6e210
|
||
|
|
synchronized_at: 2026-08-08T02:04:59Z
|
||
|
|
<!-- gitea-wiki-mirror:end -->
|
||
|
|
|
||
|
|
# 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)
|