GitHub上一个名为claude-code-best-practice的开源仓库在2026年3月登上GitHub Trending榜首,目前已获得近2万Star和1700+ Fork。这个由开发者shanraisshan维护的项目,系统整理了Claude Code的全部核心概念、84条实战技巧、7套主流开发工作流,以及来自Claude Code创造者Boris Cherny本人的官方建议。对于正在使用或计划使用Claude Code的开发者来说,这可能是目前最全面的中文参考资源之一。 Claude Code的核心架构:理解Subagents、Commands和Skills三层体系
要高效使用Claude Code,首先需要搞清楚它的三层扩展体系——这也是很多开发者最容易混淆的地方。
Subagents(子代理)是Claude Code中最强大的扩展机制。每个子代理在独立的隔离上下文中运行,拥有自己的工具集、权限、模型选择、记忆和持久身份。配置文件位于.claude/agents/.md。Boris Cherny的建议是创建功能特定的子代理(比如专门处理数据库迁移或API集成的代理),而不是泛化的"后端工程师"或"QA工程师"。他强调"说'use subagents'来把更多计算力投入到一个问题上——把任务卸载出去以保持你的主上下文干净和专注"。
Commands(命令)是注入到现有上下文中的提示模板,配置在.claude/commands/.md中,通过斜杠命令调用。命令的核心价值在于把你每天重复做的事情固化下来。Boris的原则很直接:如果你一天做一件事超过一次,就把它变成命令。
Skills(技能)是Claude Code最新也最灵活的扩展层,配置在.claude/skills//SKILL.md中。技能支持自动发现、渐进式信息披露(progressive disclosure)和上下文分叉(context fork)。与命令不同,技能是文件夹而不是单个文件——可以包含references/、scripts/、examples/等子目录来组织复杂的知识结构。
三者之间的编排模式是:Command触发流程 → Agent执行任务 → Skill提供领域知识。这个仓库提供了一个完整的天气查询编排工作流示例(/weather-orchestrator),演示了三者如何协同工作。
84条实战技巧中最值得关注的20条
这个仓库整理的84条技巧覆盖了提示词、规划、CLAUDE.md配置、代理、命令、技能、钩子、工作流、调试和日常使用等多个维度。以下是我们筛选出的最高价值建议。
关于提示词和规划。 Boris建议"挑战Claude"——比如说"grill me on these changes and don't make a PR until I pass your test"或者"prove to me this works",让Claude对比main分支和你的分支来自证工作质量。在修复效果不满意时,试试"knowing everything you know now, scrap this and implement the elegant solution"来触发Claude重新思考。规划阶段必须使用plan mode,并且可以启动第二个Claude实例以Staff Engineer的身份审查计划。
关于CLAUDE.md配置。 单个CLAUDE.md文件应控制在200行以内(HumanLayer团队甚至压缩到60行)。一个实用的检验标准是:任何开发者应该能启动Claude、说"run the tests"并一次通过——如果做不到,说明CLAUDE.md缺少关键的环境/构建/测试命令。对于大型项目,使用.claude/rules/目录拆分指令,并用 标签包裹关键规则以防止被忽略。 关于工作流管理。 在上下文使用达到50%时手动执行/compact,避免进入"Agent Dumb Zone"(代理变笨区域)。使用Opus模型做规划、Sonnet模型写代码,通过/model命令灵活切换。在提示词中使用"ultrathink"关键词触发深度推理。重要会话用/rename命名(如"TODO - refactor task"),后续通过/resume恢复。
关于调试和高级用法。 遇到问题时养成截屏并分享给Claude的习惯。通过MCP连接Chrome DevTools让Claude自主查看控制台日志。使用/loop命令设置循环监控任务(最长运行3天),比如轮询部署状态、监控构建和看护PR。使用/sandbox减少权限弹窗(Anthropic内部数据显示可减少84%的权限提示)。
7套主流开发工作流对比
这个仓库还横向对比了GitHub上7个最受欢迎的Claude Code开发工作流框架,它们都遵循相同的核心模式:研究→规划→执行→审查→发布,但各有侧重。
Superpowers(10万Star)以TDD优先和"铁律"(Iron Laws)为特色,要求全计划审查后再执行。Everything Claude Code(8.9万Star)独创了"直觉评分"(instinct scoring)机制和AgentShield安全层,拥有108+个技能文件,是规模最大的框架。GitHub官方的Spec Kit(7.9万Star)采用规格驱动开发模式,内置22+工具,强调用宪法(constitution)约束AI行为。BMAD-METHOD(4.1万Star)覆盖完整软件开发生命周期(SDLC),为不同角色定义了代理人格,适配22+平台。Get Shit Done(3.6万Star)的核心思路是保持200K的新鲜上下文窗口,通过波次执行(wave execution)和XML计划格式管理复杂任务。
对于个人开发者,Boris的建议是"vanilla cc(原版Claude Code)处理小任务比任何工作流都好"。工作流框架更适合团队协作和大型项目。
Claude Code正在替代的产品和服务
仓库中一个引人注目的部分是"Startups / Businesses"——列出了Claude Code新功能正在直接替代的产品。Code Review功能对标Greptile、CodeRabbit、Devin Review等代码审查工具。Voice Dictation对标Wispr Flow和SuperWhisper等语音输入工具。Remote Control功能甚至被标注为OpenClaw的替代。Cowork对标OpenAI Operator。Skills/Plugins体系则被社区直言"基本上就是YC那些AI wrapper创业公司"的替代。
这反映出一个清晰的行业趋势:编码代理平台正在通过功能内化快速蚕食垂直工具的市场空间。
如何开始使用这个仓库
仓库作者建议的学习路径是:第一步,像读课程一样通读整个仓库,先理解Commands、Agents、Skills和Hooks各自是什么再动手。第二步,克隆仓库并实际运行示例——试试/weather-orchestrator命令、听听Hook音效、跑跑Agent Teams,感受各组件的实际运作方式。第三步,回到自己的项目中,把这个仓库作为参考交给Claude,让它建议应该采纳哪些最佳实践。
仓库地址:github.com/shanraisshan/claude-code-best-practice,MIT开源协议,持续更新中。