agents-with-receipts

实践地图

十个章节 + 一篇可跟做的 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 官方文档——具体到每条实践的「依据」行。