Table of Contents

4 增加 Agent 效率与范围控制规则

背景与目标
最终方案
修改文件
验收结果
测试
相关提交

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

4 增加 Agent 效率与范围控制规则

类型：需求
所属 Epic：无
所属 MVP / 版本：无
状态：已完成
日期：2026-08-08
Gitea 工单：opc/dev_harness#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
结果：通过。
未验证部分：不同新项目中的实际效率提升需要通过后续任务数据验证。

4 增加 Agent 效率与范围控制规则

背景与目标

最终方案

修改文件

验收结果

测试

相关提交