claude-code-best-practice：从随意编码到智能体工程的完整指南

本文介绍 claude-code-best-practice，一个拥有超过 5.1 万 Star 的 Claude Code 最佳实践参考仓库。它系统性地整理了 Claude Code 的所有原语、12 个主流开发工作流、83 条社区技巧，是从「随意编码」到「智能体工程」的完整学习路径。

项目简介

claude-code-best-practice 由开发者 Shayan（shanraisshan）维护，使用 HTML 编写，基于 MIT 协议发布。这个仓库不是一个可安装的工具，而是一份系统化的参考手册和课程，旨在帮助开发者掌握 Claude Code 的全部能力。2026 年 3 月曾登上 GitHub Trending 日榜第一。

核心理念：不要把 Claude 当聊天机器人，而是学习其原语（Agents、Commands、Skills、Hooks、MCP），组装出适合自己的工作流。

核心概念

仓库详细介绍了 Claude Code 的所有基础原语：

原语	存放位置	说明
Subagents（子代理）	`.claude/agents/<name>.md`	特性专属代理，可抛更多计算
Commands（命令）	`.claude/commands/<name>.md`	频繁操作封装为可复用命令
Skills（技能）	`.claude/skills/<name>/SKILL.md`	文件夹形式的可分发技能包
Workflows（工作流）	编排文件	Command -> Agent -> Skill 模式
Hooks（钩子）	`.claude/hooks/`	自动格式化、权限路由、度量等
MCP Servers	`.claude/settings.json`	外部工具集成
Memory（记忆）	CLAUDE.md, rules	自动记忆和项目指令
Settings（设置）	`.claude/settings.json`	权限、模型、输出样式配置

12 大开发工作流

所有工作流遵循统一架构：Research -> Plan -> Execute -> Review -> Ship

工作流	Star 数	核心流程
Superpowers (Boris Cherny)	175k	brainstorming -> worktrees -> plans -> subagent dev -> TDD -> code review
Everything Claude Code (ECC)	171k	/ecc:plan -> /tdd -> /code-review -> /security-scan -> /e2e -> merge
Spec Kit	92k	constitution -> clarify -> specify -> plan -> tasks -> implement
gstack	88k	office-hours -> plan -> implement -> review -> qa -> ship
Get Shit Done (GSD)	59k	new-project -> discuss -> plan -> execute -> verify -> ship
Matt Pocock Skills	51k	grill-with-docs -> to-prd -> to-issues -> triage -> tdd -> diagnose
BMAD-METHOD	46k	product-brief -> create-prd -> architecture -> sprint -> dev-story
OpenSpec	45k	propose -> apply -> archive
oh-my-claudecode	32k	deep-interview -> team -> plan -> prd -> exec -> verify -> merge
agent-skills	27k	spec -> plan -> build -> test -> review -> ship
Compound Engineering	16k	ideate -> brainstorm -> plan -> work -> code-review -> optimize
HumanLayer	11k	create_plan -> validate -> implement -> iterate -> commit

83 条技巧精华

技巧来源于 Claude Code 核心团队成员（Boris Cherny、Thariq、Dex、Lydia、Matt 等），按 14 个类别组织：

提示技巧

挑战 Claude：要求「从头实现更优雅的方案」而非逐步修改
让 Claude 自行修 bug：提供错误信息而非告诉它怎么改

上下文管理

上下文衰减在 300-400k token 开始明显
dumb zone 出现在约 40% 上下文时
使用 rewind 优于尝试口头纠正
/compact 时附带提示以保留关键上下文

CLAUDE.md 最佳实践

CLAUDE.md 控制在 200 行以内
rules 按需加载，monorepo 使用多文件
让 Claude 根据提示自动改进你的 CLAUDE.md

代理与技能

Skills 是文件夹不是单个文件
使用 context:fork 隔离运行技能
技能描述是触发器，写好描述至关重要

工具使用

iTerm/tmux 优于 IDE 内嵌终端
每日更新 Claude Code，关注 changelog
PR 保持小而聚焦，使用 squash merge

技能和代理集合

仓库收录了大量社区资源：

技能集合：

名称	Star 数	技能数
anthropics/skills	127k	17
mattpocock/skills	51k	18
wshobson/agents	35k	152
scientific-agent-skills	20k	134
awesome-agent-skills	20k	930+

代理集合：

名称	Star 数	代理数
msitarzewski/agency-agents	94k	185
VoltAgent/awesome-claude-code-subagents	19k	144

使用建议

把仓库当作课程阅读，而非照搬的工作流
学习原语，组装自己的工作流
运行 /weather-orchestrator 看完整的编排流程
从 HOT 板块了解最新功能
订阅 Reddit（r/ClaudeAI、r/ClaudeCode）和 YouTube 频道保持跟进

项目链接

GitHub 仓库：https://github.com/shanraisshan/claude-code-best-practice
许可证：MIT

字节笔记本