claude-code-best-practice 是 GitHub 热门的 Claude Code 工程实践手册，从 vibe coding 升级到 agentic engineering，系统梳理子代理、命令、Skills、Hooks、MCP、记忆与权限等最佳实践与可落地实现。适合想给编码 Agent 建立工程纪律、统一团队开发习惯的开发者。
claude-code-best-practice 是 GitHub 上热门的 Claude Code 工程实践手册，口号是“from vibe coding to agentic engineering——practice makes claude perfect”。它把 Claude Code 的各个能力模块——子代理（Subagents）、命令（Commands）、Skills、Hooks、MCP 服务器、插件、设置、记忆（Memory）、检查点与上下文窗口——逐一拆成“最佳实践 + 可落地实现”两份文档，还附编排工作流示例。对想从“随手让 Agent 写代码”升级到“给 Agent 立工程规矩”、并在团队间统一开发语言的开发者，它是一份现成的参考大全。
区别在于“有没有纪律”。裸用容易想到哪写到哪、跳过规划、漏掉权限与记忆管理；这份手册把每个能力都讲清“什么时候用、怎么配、容易踩什么坑”，并给出真实项目的实现样例（如 .claude/agents、.claude/commands、.mcp.json、CLAUDE.md）。它更像一本工程手册，而不是一个会自动干活的技能包。
九大块：Subagents（把大任务拆给专职子代理）、Commands（可复用斜杠命令）、Skills（项目级可加载技能）、Workflows（多步编排）、Hooks（事件钩子自动执行）、MCP Servers（接外部工具与 API）、Plugins（可分发插件包）、Settings（权限/模型/输出风格/沙箱等）、Memory（CLAUDE.md 与项目记忆）。每块都同时给“最佳实践”文档和“实现样例”链接，方便照抄落地。
两者都值。个人能照着把单台 Claude Code 调得更稳；团队则能把命令、Skills、Settings 固化成共享配置，保证每个人、每个 Agent 对同一项目有统一的开发语言与权限边界。项目越大、协作者越多，规范带来的收益越明显。
建议先看“How to Use”和 CONCEPTS 表，按自己当前卡住的点挑模块：如果 Agent 总跑偏就看 Subagents 与 Commands；如果要接外部系统就看 MCP；如果会话越长越蠢就看 Memory 与 Context Window。手册强调“先理解概念，再照实现落地”，不鼓励一股脑全装上。
区别在于“有没有纪律”。裸用容易想到哪写到哪、跳过规划、漏掉权限与记忆管理；这份手册把每个能力都讲清“什么时候用、怎么配、容易踩什么坑”，并给出真实项目的实现样例（如 .claude/agents、.claude/commands、.mcp.json、CLAUDE.md）。它更像一本工程手册，而不是一个会自动干活的技能包。
九大块：Subagents（把大任务拆给专职子代理）、Commands（可复用斜杠命令）、Skills（项目级可加载技能）、Workflows（多步编排）、Hooks（事件钩子自动执行）、MCP Servers（接外部工具与 API）、Plugins（可分发插件包）、Settings（权限/模型/输出风格/沙箱等）、Memory（CLAUDE.md 与项目记忆）。每块都同时给“最佳实践”文档和“实现样例”链接，方便照抄落地。
两者都值。个人能照着把单台 Claude Code 调得更稳；团队则能把命令、Skills、Settings 固化成共享配置，保证每个人、每个 Agent 对同一项目有统一的开发语言与权限边界。项目越大、协作者越多，规范带来的收益越明显。
建议先看“How to Use”和 CONCEPTS 表，按自己当前卡住的点挑模块：如果 Agent 总跑偏就看 Subagents 与 Commands；如果要接外部系统就看 MCP；如果会话越长越蠢就看 Memory 与 Context Window。手册强调“先理解概念，再照实现落地”，不鼓励一股脑全装上。