研发 Agent 控制台

研发 Agent 控制台

更新时间：2026-06-02

这个入口面向研发团队。它把 zhctprompt 从“资料控制项目”进一步收敛为一个可执行的研发 Agent 工作台：需求进来后，Agent 先按契约拆任务，再到正确业务仓库执行，最后由 harness 校验证据是否完整、写法是否合规、结论是否可追溯。

1. 研发 Agent 负责什么

范围 说明 入口
需求归一 把聊天、会议、云效、截图、微盘资料整理成研发任务契约 control/development-agent/agent-contract.md
代码执行 在 zhctproject/<repo> 或登记的业务仓库中改代码、跑测试、留证据 modules/product/development/README.md
交付证据 生成 summary、source-index、验证记录、任务索引和人审页 control/development-agent/task-pack-template.md
Harness 校验 检查文件位置、证据字段、任务索引、HTML、人审材料和禁区 control/development-agent/harness/README.md

2. 人怎么用

管理者 / 研发负责人

  1. 看 control/development-agent/folder-map.csv，确认资料应该落在哪里。
  2. 看 control/development-agent/human-review-guide.md，按人审清单检查 Agent 输出。
  3. 运行 harness：
python3 control/development-agent/harness/dev_agent_harness.py --repo-root .

开发同事

  1. 先把需求写成任务契约，不要直接让 Agent 改代码。
  2. 明确目标仓库、分支、测试命令、验收口径和不能碰的范围。
  3. 代码改动完成后，至少留下 summary.md、source-index.csv、验证命令和任务索引条目。

Agent / Codex

  1. 先读 control/development-agent/agent-contract.md。
  2. 再读业务仓库的 AGENTS.md / README.md / 本项目对应 work_<project>/。
  3. 输出前运行 harness；不通过就不能写“完成”。

3. 正确写入路径

要写什么 写到哪里 不能写到哪里
研发 Agent 规则 control/development-agent/ 不要散落到临时 work/
可复用 AI 工程方法 standards-stack/ai-engineering/、standards-stack/agent-skills/ 不要只放最终回复
某次任务证据 work/YYYY-MM-DD-topic/ 或 work_<project>/... 不要混进顶层
业务代码 zhctproject/<repo> 或登记的本地业务仓库 不要复制进 zhctprompt
人看的页面 顶层 HTML 或任务证据包 HTML 不要只留 CSV

4. Harness 要确保什么

Harness 不是替代人工评审，而是先挡住低级错误：

5. 当前状态

6. 云效跑通后的阶段成果

当前研发 Agent 工作台已经有了可接云效任务的基本闭环：

云效任务源 -> 本地任务契约 -> 研发 Agent 执行层 -> 验证与证据包 -> harness 校验 -> 人审与任务索引

阶段成果包：

文件 用途
work/2026-06-02-yunxiao-development-agent-stage-results/summary.md 给 AI 和团队恢复上下文的阶段总结
work/2026-06-02-yunxiao-development-agent-stage-results/yunxiao-development-agent-stage-results.html 给人看的阶段成果页
work/2026-06-02-yunxiao-development-agent-stage-results/stage-achievement-map.csv 云效、微盘、研发 Agent、harness 的成果地图
work/2026-06-02-yunxiao-development-agent-stage-results/next-stage-roadmap.csv 下一阶段试跑路线
work/2026-06-02-yunxiao-development-agent-stage-results/yunxiao-agent-loop.md 云效到研发 Agent 的标准闭环

下一步不是继续写更多说明，而是选择一个真实云效研发任务，完整跑通“任务契约 -> 业务仓库修改 -> 验证 -> 证据包 -> 任务索引 -> harness 通过 -> 人审”。