AI 协作深读清单
这套心法不是凭空来的。筛过的外部资源，按主题分；先看核心 10 个。
More Agents, More Agency 和 AGENTS.md 那两篇不是凭空来的。下面是我筛过的外部资源，按主题分。只想看最相关的，就看第一张表。
核心读物（先看这 10 个）
| 资源 | 为什么值得看 |
|---|---|
| AGENTS.md | 给 coding agent 的开放标准格式，60k+ 项目在用 |
| GitHub: How to write a great agents.md | 2500+ 仓库总结：明确 persona、具体命令、项目结构、边界、好/坏输出示例 |
| OpenAI Codex Best Practices | 把 agent 当可持续改进的 teammate：Goal/Context/Constraints/Done-when、Plan mode |
| Simon Willison: Agentic Engineering Patterns | 长期维护型模式库；区分 vibe coding 与专业 agentic engineering |
| Addy Osmani: How to write a good spec for AI agents | spec 怎么写给 agent：写清楚、控上下文、随项目演化 |
| Armin Ronacher: Agentic Coding Recommendations | 实战控 token、避免过度工具调用；失败模式也写了 |
| HumanLayer: 12-Factor Agents | 让 LLM 软件可靠到能上生产的工程原则 |
| Hamel + Shreya: LLM Evals FAQ | evals / trace / error analysis；把”用证据管理 AI”升级成 eval loop |
| BMAD Method | 多角色 agent（PM/Architect/Dev/UX）协作框架 |
| cnfjlhj/ai-collab-playbook | 中文协作 playbook，参考目录与读者路径 |
GitHub 仓库
| 项目 | 适合看的点 |
|---|---|
| awesome-claude-code | Claude Code 生态 curated：skills / hooks / commands / orchestrators |
| awesome-claude-code-workflows | cookbook：Plan-Build-Review、多 agent、context/memory、TDD |
| awesome-cursorrules | Cursor 规则库：项目规则怎么写、怎么拆、怎么减重复 |
| OWASP secure-agent-playbook | 安全 agent playbook：checklist、决策标准、证据高于感觉 |
| awesome-evals | agent eval 资源，补 Eval / Golden / Failure cases |
官方文档
| 来源 | 看什么 |
|---|---|
| Claude Code Memory / CLAUDE.md | 短规则为何更易被遵守；哪些放常驻规则 vs 专项文档 |
| Claude Code Hooks | 确定性控制：在生命周期点强制执行规则，不靠模型自觉 |
| Claude Code Subagents | Planner / Executor / Reviewer 配置化 |
| Claude Code Skills | 把任务打包成可复用 skill + 质量 eval |
| Anthropic: Building Effective Agents | workflow vs agent、evaluator-optimizer、orchestrator-workers；克制原则 |
| OpenAI: Practical Guide to Building Agents | 工具设计 / orchestration / guardrails / 多 agent handoffs |
| OpenAI: Agent Improvement Loop | traces → feedback → evals → 改 harness 的飞轮 |
博主
| 人 | 看什么 |
|---|---|
| Simon Willison | agentic engineering patterns；用 agent 放大已有 expertise，不是不看代码 |
| Addy Osmani | spec-driven AI coding，把 Plan-first 写成工程模板 |
| Armin Ronacher | 真实 Claude Code 习惯、token/context 控制、失败经验 |
| Hamel Husain / Shreya Shankar | evals / trace / error analysis，把人评变可持续系统 |
| Dex Horthy (HumanLayer) | 12-Factor Agents：“Agent 越强，控制流越要清楚” |
| Maggie Appleton | AI 产品界面：不是所有 AI 都该做成 chat |
| Geoffrey Litt | malleable software、user agency |
| Andrej Karpathy | Software 3.0 时代判断（背景，非操作模板） |
AI-UX / 产品设计
| 资源 | 补哪一块 |
|---|---|
| Google People + AI Guidebook | 用户需求 / mental model / 反馈 / 控制 / AI 可信度校准 |
| Microsoft HAX Toolkit | 18 条 Human-AI 交互准则 + workbook |
| IBM Carbon for AI | AI 生成内容怎么在界面里标 |
| Basecamp Shape Up | 做减法、收 scope、明确非目标 |
| NN/g 10 Usability Heuristics | 状态可见、用户语言、错误恢复 |
社区（看真实失败模式）
| 社区 | 看什么 |
|---|---|
| r/ClaudeAI · r/ClaudeCode | CLAUDE.md / Skills / memory 实践 + “它不遵守规则怎么办” |
| r/codex | AGENTS.md / plan mode / review workflow |
| r/cursor | 规则怎么写才不失效、怎么逼 agent 先理解任务 |
| Hacker News | Armin / Simon 文章的高质量争论，评论里常有反例和边界 |
好的 system prompt 长什么样
想知道顶级 AI 产品的 system prompt 怎么组织规则与边界，直接看真实泄露的：asgeirtj/system_prompts_leaks（47k star，收集 Claude / ChatGPT / Cursor 等的系统提示词）。
重点看 Anthropic / claude-design.md：强制产物形态、明确写出反模式（“Never use scrollIntoView…”）、按 skill 分工，且强调”少讲实现、多讲视觉、说人话”。可以当”好规则文件长什么样”的活样板。
建议顺序：先 AGENTS.md 官网和 GitHub 那篇 → Codex Best Practices → Simon Willison → Addy → Armin → Evals FAQ；第二轮再进 Claude Code 的 hooks / subagents / skills 和几套 AI-UX 指南。