后续 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 必须记录:
- Task id。
- Agent profile。
- Runtime id。
- Repo 和 scope。
- Prompt/context version。
- Allowed tools。
- Logs。
- Artifacts。
- Tests run。
- Cost/usage。
- Handoff summary。
- Final status。
不要最先自动化什么
不要从这些场景开始:
- 生产部署。
- 数据库 migration。
- Auth/permission 变化。
- 支付逻辑。
- 大范围重构。
- 多 repo 变更。
- 安全敏感操作。
先从有边界、可逆、低风险任务开始。
下一步阅读
读完或填完这份文档后,通常继续看:
- 91-Agent协作架构-agent-collaboration-architecture.md:确认人类闭环稳定后,再看后续 Agent 协作架构。