研发 Agent 与 Harness 工程总结

任务目标

按 Jack 要求，把 zhctprompt 进一步整理成面向研发的 Agent 工作台，并建立 harness 工程，确保 Agent 输出始终按正确路径、正确证据和正确验收口径写入。

已完成

• 新增人看的研发 Agent 入口：DEVELOPMENT_AGENT_CONSOLE.md 和 DEVELOPMENT_AGENT_CONSOLE.html。
• 新增研发 Agent 控制目录：control/development-agent/。
• 新增执行契约：control/development-agent/agent-contract.md。
• 新增文件夹写入地图：control/development-agent/folder-map.csv。
• 新增人审指南：control/development-agent/human-review-guide.md。
• 新增任务证据包模板：control/development-agent/task-pack-template.md。
• 新增 harness 工程：control/development-agent/harness/dev_agent_harness.py、checks.csv 和样例任务包。
• 新增 Agent registry 条目：zhct-development-agent。
• 新增 development task-bus 队列目录。
• 更新 modules/product/development/README.md，把研发 Agent 作为开发模块入口。
• 更新 standards-stack/ai-engineering/ai-engineering-map.csv，登记 AI-DEV-AGENT-001。

验证

已运行验证命令：

python3 control/development-agent/harness/dev_agent_harness.py --repo-root .
python3 control/development-agent/harness/dev_agent_harness.py --repo-root . --task-dir control/development-agent/harness/cases/sample-development-agent-output
python3 control/scripts/task_index.py validate

结果：

• development-agent harness passed
• 样例任务包 development-agent harness passed
• control/task-index/tasks.tsv 已从 162 个 item 文件重建并通过校验。
• CSV 字段数检查通过：folder-map.csv、checks.csv、本次 source-index.csv、ai-engineering-map.csv 字段数一致。

边界

• 本次未修改任何业务仓库代码。
• Harness 当前检查的是结构、证据和任务索引，不替代代码 review、单元测试、接口测试、客户验收或生产发布审批。
• 研发 Agent 不能在没有任务契约、分支/worktree、验证路径和人工门禁时处理高风险任务。

下一步

• 用一个真实云效研发任务试跑研发 Agent：从任务契约、代码修改、验证、证据包到 harness 通过。
• 把 harness 逐步接入 pre-submit 检查或周报自动化。
• 根据首次试跑结果增加更细的代码仓库规则、API 契约检查和人审评分项。