十个章节 + 一篇可跟做的 walkthrough,分两条轴:01-08 讲 agent 读得懂这个仓库,09-10 讲 agent 验得动自己的工作成果。只放有出处的断言:每条实践按「场景 → 做法(可复制示例)→ 依据(官方链接)→ 边界」展开,验证于 2026-08,过期即删。
新上手:先跟做 00 walkthrough,再读 01 Memory 文件 和 02 机制选型——这三篇解决”配置放哪、写什么”。想让 agent 自己验证、敢自动合 PR:从 09 可验证的仓库 的阶段门读起,再看 10 硬约束下沉。其余章节按需查。
| # | 章节 | 一句话 |
|---|---|---|
| 00 | 从零配齐 agent 基建 | 可跟做:AGENTS.md → 条件规则 → hook → lint 进 CI,每步可验证 |
| 01 | Memory 文件 | AGENTS.md / CLAUDE.md 的写法、取舍与维护 |
| 02 | 机制选型 | memory / rules / skills / hooks / subagents 什么时候用哪个 |
| 03 | 任务框架与规划 | Goal / Context / Constraints / Done-When,先探索后编辑 |
| 04 | 验证闭环 | agent-TDD、独立评审、diff 对账 |
| 05 | 权限与沙箱 | 渐进放权、四工具档位、CI 全自动的安全前提 |
| 06 | 上下文管理 | /clear 纪律、探索隔离、计划落盘、预算意识 |
| 07 | 并行与编排 | 独立性判定、文件所有权、git worktree |
| 08 | 安全与团队治理 | 不可信输入、secrets 拦截、配置入库 |
| 09 | 可验证的仓库 | 单命令验证回路、确定性、失败证据、阶段门顺序不可跳 |
| 10 | 硬约束下沉 | 结构 > 类型 > 机械 CI > 提示;存量先立基线再转 error |
agents.md 规范 · Anthropic Claude Code 官方文档 · Anthropic steering 指南 · OpenAI Codex 官方文档 · Cursor 官方文档 · GitHub Copilot 官方文档——具体到每条实践的「依据」行。