GitHub 上有个仓库叫 claude-code-best-practice,聚合了 Claude Code 生态里能找到的几乎一切:官方文档、核心工程师的推文技巧、社区视频、外部工作流仓库、可运行样例。我花了不少时间把它理了一遍,结论先放这里:
值得收藏,不值得”学完”——当百科 10/10,当教材 6/10。
它没有学习路径设计——你必须自带地图进去,否则会在几百个文件里迷路。这篇就是那张地图。
基本信息
| 名称 | claude-code-best-practice |
| 维护者 | shanraisshan(社区维护的 GitHub 仓库) |
| 形式 | 百科式索引仓库,不是课程也不是教程 |
| 时长 | 地基约 3-4 小时,其余按需查阅 |
| 门槛 | 需要已经在用 Claude Code,纯新手不适合 |
| 我的评分 | 索引 10/10 · 教材 6/10 —— 一个数字反而撒谎 |
这个仓库到底有什么
表面看是一张把所有东西并列的大杂烩 README。理清之后,其实只有 5 层:
| 层 | 内容 | 价值 |
|---|---|---|
| 1 | 12 个核心原语:Subagent / Command / Skill / Hook / MCP / Memory / Settings 等 | 地基,跳不过 |
| 2 | 装配模式:Command → Subagent → Skill 的三层组装,附唯一可运行的 weather demo | 全仓库最重要的一份样例 |
| 3 | 工作流方法论:11 个外部 workflow 仓库(Superpowers / Spec Kit / BMAD 等)的索引 | 挑 1-2 个看,不要逐个学 |
| 4 | 82 条实操 tips:聚合自 Claude Code 核心工程师 Boris、Thariq 的推文 | 按场景查,不要通读 |
| 5 | 进阶报告:13 篇深度调研(auto-memory 内核、配置层级、context 退化等) | 想搞懂”为什么”时再翻 |
仓库里另附一个完全独立的内容:Andrej Karpathy 的编码准则 skill——它讲”如何写好代码”,不讲”如何用 Claude Code”,不要混在一起学。
读完最有用的三件事
一、Claude Code 的全部能力,只有 12 个原语
看起来功能繁多,拆开后全部建立在 12 个独立组件上,其中最核心的是三个:Command(用户触发的 prompt 模板)、Subagent(在隔离上下文里跑的自治 agent)、Skill(可被自动发现的知识包)。其余一切——插件、工作流、多 agent 编排——都是这 12 个原语的组合。先能用一句话说清每个原语解决什么不同的问题,再谈别的。
二、所有花哨的工作流,收敛到同一个模式
11 个外部 workflow 仓库,命名五花八门,但全部收敛为:
Research → Plan → Execute → Review → Ship
区别只是每家给各阶段起了不同名字、加了不同的子循环。想通这一点,你就不需要”学会 11 个工作流”——你需要的是决定自己的这五步在 Claude Code 里长什么样。
三、最值钱的技巧都在管理上下文,不在写 prompt
82 条 tips 里信号量最高的三条,没有一条是关于措辞的:
- plan mode 永远先开 —— 先规划再动手
- context rot 在 ~40% 就开始 —— 上下文用量过 40% 就该收尾或清场,过 60% 别做复杂任务
- rewind 优于修正 —— 失败了就回滚重来,不要在上下文里堆”失败 + 修正”的污染
三条指向同一个心智模型:你的杠杆在会话与上下文管理,不在 prompt 的遣词造句。
最大槽点:伪深度
三个具体表现:
- 同一件事被切成三份文档 ——
best-practice/讲是什么、implementation/给样例、reports/做调研,经常讲同一个东西,读一份就够 - 没有学习路径 —— 没有”先学什么后学什么”的认知阶梯,全靠读者自己组织
- README 一张大表混所有维度 —— 概念、beta 特性、视频、技巧、外部仓库并列,看起来全面,实际无从下手
加起来说明一件事:它是仓库,不是课程。 把它当课程从头读,是这个仓库最差的打开方式。
谁该收藏 / 谁别碰
该收藏(按你带着什么问题来,三类不重叠):
| 你的问题 | 去仓库的哪里 |
|---|---|
| ”Claude Code 到底有什么?” —— 想要概念全貌 | 第 1 层的 12 个原语文档 |
| ”我要搭复杂的多 agent 工作流” —— 想要组装方法 | 第 2 层 weather demo + 第 3 层 workflow 索引 |
| ”我卡在一个具体问题上” —— 要查速查表 | 第 4 层 82 tips + 第 5 层调研报告 |
别碰:
- 还没用过 Claude Code 的纯新手 —— 这里没有认知阶梯,先去跑通官方入门再来
- 想要 step-by-step 跟练教程的人 —— 它是索引不是教程,不会牵着你的手
相关概念
仓库第 1 层的核心原语,本站概念库已有单篇详解: Subagent 子代理 · Slash Command 斜杠命令 · MCP · Hook 钩子 · CLAUDE.md 与 Memory
Skill 相关概念: Skill 是什么 · Skill 和其他选项怎么选 · Skill 如何加载与匹配 · Skill 进阶技巧
我的下一步
- 跑通 weather demo —— 仓库里唯一完整可运行的 Command → Subagent → Skill 三层样例
- 自己写一个三层小工具 —— 比如”周度回顾”:一个 Command 入口、一个隔离上下文的 Subagent、一个领域知识 Skill
- 单独消化 Karpathy 编码准则 —— 装入全局 skills 当背景知识,值得另写一篇