2026-08-08 09:40:02 +08:00
|
|
|
|
<!-- gitea-wiki-mirror:start -->
|
|
|
|
|
|
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
|
|
|
|
|
|
wiki_page: Task-4-Agent-Efficiency-Scope
|
|
|
|
|
|
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-4-Agent-Efficiency-Scope.-
|
2026-08-08 10:00:15 +08:00
|
|
|
|
wiki_revision: 3c2d8b9e5d82a0d3da5b71ef9d889e11d813d27d
|
|
|
|
|
|
synchronized_at: 2026-08-08T01:59:47Z
|
2026-08-08 09:40:02 +08:00
|
|
|
|
<!-- gitea-wiki-mirror:end -->
|
|
|
|
|
|
|
|
|
|
|
|
# 4 增加 Agent 效率与范围控制规则
|
|
|
|
|
|
|
|
|
|
|
|
- 类型：需求
|
|
|
|
|
|
- 所属 Epic：无
|
|
|
|
|
|
- 所属 MVP / 版本：无
|
2026-08-08 10:00:15 +08:00
|
|
|
|
- 状态：已完成
|
2026-08-08 09:40:02 +08:00
|
|
|
|
- 日期：2026-08-08
|
|
|
|
|
|
- Gitea 工单：[opc/dev_harness#4](http://ilaer.eicp.net:8418/opc/dev_harness/issues/4)
|
|
|
|
|
|
- Wiki 页面：Task-4-Agent-Efficiency-Scope
|
|
|
|
|
|
- Wiki revision：见本地镜像头
|
|
|
|
|
|
|
|
|
|
|
|
## 背景与目标
|
|
|
|
|
|
|
|
|
|
|
|
DevHarness 已有完整安全和交付闭环，但缺少对无关扩展、重复检查、预防性验证和完成后继续优化的限制。本任务在不削弱安全、测试和归档的前提下增加效率规则。
|
|
|
|
|
|
|
|
|
|
|
|
## 最终方案
|
|
|
|
|
|
|
|
|
|
|
|
- 严格控制范围：默认按用户确认目标和工单执行，只限制无关产物、无关验证和相邻问题。
|
|
|
|
|
|
- 渐进执行和修复：完成必要前置检查后，用最小命令获得真实反馈，一次处理首个可行动错误。
|
|
|
|
|
|
- 复用已验证事实：只在同一任务和同一环境状态下复用，关键前提变化时重检。
|
|
|
|
|
|
- 明确停止条件：完成用户验收标准和仓库必要闭环后停止，首次运行成功不等于完成。
|
|
|
|
|
|
- 安全、高风险前置检查、代码修改后的测试、提交前状态、推送前远端检查和 Skill 规则不允许省略。
|
|
|
|
|
|
- Harness 检查开发工作流镜像和 AGENTS 中四组章节是否存在。
|
|
|
|
|
|
|
|
|
|
|
|
## 修改文件
|
|
|
|
|
|
|
|
|
|
|
|
- `AGENTS.md`：增加效率与范围控制的完整规则。
|
|
|
|
|
|
- `CLAUDE.md`：增加简明执行入口。
|
|
|
|
|
|
- `Development-Workflow` Wiki：增加长期工作流说明。
|
|
|
|
|
|
- `docs/01-workflow.md`：Wiki 更新后的只读镜像。
|
|
|
|
|
|
- `dev_scripts/check_harness.py`：检查四组核心规则章节。
|
|
|
|
|
|
- `tests/test_harness_docs.py`：验证当前 Agent 规则结构。
|
|
|
|
|
|
|
|
|
|
|
|
## 验收结果
|
|
|
|
|
|
|
|
|
|
|
|
| 验收标准 | 结果 |
|
|
|
|
|
|
|---|---|
|
|
|
|
|
|
| 范围限制不禁止任务必需或仓库强制产物 | 通过 |
|
|
|
|
|
|
| 渐进执行保留安全和高风险前置检查 | 通过 |
|
|
|
|
|
|
| 事实复用包含失效条件和重检例外 | 通过 |
|
|
|
|
|
|
| 最小验收包含完整项目闭环 | 通过 |
|
|
|
|
|
|
| 相邻问题不会自动混入 | 通过 |
|
|
|
|
|
|
| Harness 检查四组章节 | 通过 |
|
|
|
|
|
|
| Wiki、测试和严格检查通过 | 通过 |
|
|
|
|
|
|
|
|
|
|
|
|
## 测试
|
|
|
|
|
|
|
|
|
|
|
|
- 执行命令：`python -m unittest discover -s tests -v`
|
|
|
|
|
|
- 结果：17/17 通过。
|
|
|
|
|
|
- 执行命令：`python dev_scripts/check_harness.py --strict`
|
|
|
|
|
|
- 结果：通过。
|
|
|
|
|
|
- 执行命令：`python dev_scripts/sync_wiki_docs.py --check`
|
|
|
|
|
|
- 结果：13/13 映射一致。
|
|
|
|
|
|
- 执行命令：`python -m compileall -q dev_scripts tests`
|
|
|
|
|
|
- 结果：通过。
|
|
|
|
|
|
- 执行命令：`git diff --check`
|
|
|
|
|
|
- 结果：通过。
|
|
|
|
|
|
- **未验证部分**：不同新项目中的实际效率提升需要通过后续任务数据验证。
|
|
|
|
|
|
|
|
|
|
|
|
## 相关提交
|
|
|
|
|
|
|
|
|
|
|
|
- `d3df733` docs: 增加 Agent 效率与范围控制 (#4)
|
