后续 Agent 就绪要求

目的

这是后续阶段文档。只有当 02-L0最小闭环-l0-minimum-closure.md 中的五条硬规则能稳定执行后,才应该读这份文档。

定义 AI/Agent 自动化接入工程流程前,必须具备哪些条件。

原则

Agent 应该加速明确的流程,而不是发明流程。

接入 Agent 前,先确认人类闭环存在:任务在哪里、owner 是谁、scope 是什么、怎么验收、证据在哪里、谁 approval。缺任何一项,都应先补人类闭环,而不是让 Agent 猜。

就绪检查表

领域 Agent 执行前必须具备
Work intake 任务有 Driver、Approver、验收标准、状态
Scope repo/module/path 边界已知
Runtime agent 在受控环境运行
Context 系统能打包任务、仓库、历史、规范
Output run 必须产出结构化 handoff 和 artifacts
Review human approval gate 存在
Tests 相关命令已知
Observability logs、run status、error classification
Security secrets、tool policy、repo grants 有边界
Audit actor 和决策链路被记录

如果这些条件只在口头上成立,不算就绪。它们必须能在任务、PR、run、artifact 或 audit log 中找到。

Agent 接入顺序

个人 coding assistant
-> PR review assistant
-> 有边界的 task runner
-> 带 logs/artifacts/approval 的 run
-> multi-agent coordination
-> autonomous workflow

Agent 执行记录契约

每次 Agent run 必须记录:

  1. Task id。
  2. Agent profile。
  3. Runtime id。
  4. Repo 和 scope。
  5. Prompt/context version。
  6. Allowed tools。
  7. Logs。
  8. Artifacts。
  9. Tests run。
  10. Cost/usage。
  11. Handoff summary。
  12. Final status。

不要最先自动化什么

不要从这些场景开始:

  1. 生产部署。
  2. 数据库 migration。
  3. Auth/permission 变化。
  4. 支付逻辑。
  5. 大范围重构。
  6. 多 repo 变更。
  7. 安全敏感操作。

先从有边界、可逆、低风险任务开始。

下一步阅读

读完或填完这份文档后,通常继续看: