diff --git a/Task-4-Agent-Efficiency-Scope.-.md b/Task-4-Agent-Efficiency-Scope.-.md new file mode 100644 index 0000000..1fe685b --- /dev/null +++ b/Task-4-Agent-Efficiency-Scope.-.md @@ -0,0 +1,62 @@ +# 4 增加 Agent 效率与范围控制规则 + +- 类型:需求 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 +- 日期: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)