claude-code-best-practice

从 vibe coding 走向代理式工程，把 Claude Code 真正用起来。

这是一个围绕 Claude Code 最佳实践整理的中文仓库，聚焦三类内容：

• 概念：commands、agents、skills、hooks、memory、MCP、settings 等核心构件
• 实战：工作流编排、Agent Teams、RPI、定时任务、项目级 CLAUDE.md 设计
• 资料：技巧贴、视频整理、专题报告，以及与其他工作流仓库的横向对比

你会在这里找到什么

模块	说明
best-practice	各能力点的最佳实践说明
implementation	对应能力在项目中的落地示例
tutorial	从入门到进阶的教学材料
orchestration-workflow	命令、代理、技能如何串成完整工作流
agent-teams	多代理团队协作示例
development-workflows	其他热门工作流仓库的横向整理
tips	社区与官方成员分享的使用技巧
videos	访谈、播客与讲解视频中文整理
reports	深入专题报告与图表
changelog	跟踪文档和资料更新历史

核心概念

概念	位置	作用
Subagents	.claude/agents/<name>.md	独立上下文中的专门角色，可配置工具、模型和权限
Commands	.claude/commands/<name>.md	作为入口进行编排、提问和流程分发
Skills	.claude/skills/<name>/SKILL.md	可复用的知识包或执行套路
Hooks	.claude/hooks/	在生命周期节点触发脚本、HTTP、提示词或代理处理
MCP Servers	.claude/settings.json、.mcp.json	连接数据库、浏览器、外部 API 与各类工具
Settings	.claude/settings.json	模型、权限、沙箱、界面与团队设置
Memory	CLAUDE.md、.claude/rules/	持久项目上下文与路径级规则
CLI 启动参数	claude [flags]	控制模型、交互模式、权限模式与环境行为

推荐先看

1. 编排工作流

先看 orchestration-workflow/orchestration-workflow.md。

这里展示了最关键的一条链路：

Command -> Agent -> Skill

配套资源：

• 结构说明
• 工作流图
• 实际输出示例

2. 项目知识与规则

建议结合以下内容一起看：

• claude-memory.md
• claude-settings.md
• claude-subagents.md
• claude-commands.md
• claude-skills.md

3. 多代理与团队化执行

• Agent Teams
• Claude Agent Teams 实现
• RPI 工作流

工作流参考

这一部分收录了其他有代表性的开源工作流项目，方便横向比较：

项目	特色
Everything Claude Code	大规模规则集、AgentShield、跨语言实践
Superpowers	TDD-first、计划优先、严格约束执行
Spec Kit	spec-driven 工作方式与命令模板
gstack	多角色审查、并行执行、层级化技能
Get Shit Done	波次执行、超长上下文、批量命令
BMAD-METHOD	完整 SDLC 与技能化角色
OpenSpec	brownfield 与 delta spec 流程
oh-my-claudecode	团队编排、tmux worker、计划驱动执行
HumanLayer	大仓库协作、RPI、上下文工程

配套目录：

• development-workflows/cross-model-workflow
• development-workflows/rpi

技巧与经验

优先阅读这些内容：

• How I use Claude Code - 13 tips
• 10 tips for using Claude Code from the team
• 12 ways how people are customizing their claudes
• Lessons from Building Claude Code: How We Use Skills
• 15 Hidden & Under-Utilized Features in Claude Code

常见经验总结：

• 复杂任务先进入 plan mode
• 让 Claude 自己运行终端并查看日志
• 用 /code-review 做回归前检查
• 使用 worktree 并行推进多个分支任务
• 长会话中及时 /compact
• 通过小 PR 和频繁提交降低返工成本

视频整理

标题	来源	YouTube
我们在 Research-Plan-Implement 上犯过的所有错误	MLOps Community	YouTube
与 Boris Cherny 一起拆解 Claude Code	The Pragmatic Engineer	YouTube
Claude Code 负责人：编程被解决之后会发生什么	Lenny's Podcast	YouTube
与创建者 Boris Cherny 深入聊 Claude Code	Y Combinator	YouTube
Claude Code 团队公开的内部经验	Every	YouTube

专题报告

推荐从这些报告开始：

• claude-agent-sdk-vs-cli-system-prompts
• claude-in-chrome-v-chrome-devtools-mcp
• claude-global-vs-project-settings
• claude-advanced-tool-use
• llm-day-to-day-degradation

如何使用这个仓库

1. 先理解 commands、agents、skills、hooks 各自解决什么问题。
2. 再跑一两个示例工作流，例如 /weather-orchestrator 或 Agent Teams。
3. 回到你自己的项目，让 Claude 参考本仓库挑选最值得引入的做法。

外部社区

• Reddit: r/ClaudeAI、r/ClaudeCode、r/Anthropic
• X: Claude、Anthropic、Boris、Thariq
• YouTube: Anthropic、Lenny's Podcast、Y Combinator

相关仓库

• claude-code-hooks
• codex-cli-best-practice
• codex-cli-hooks

说明

本仓库以中文整理为主，但以下内容会保留英文原样：

• 路径、命令、代码块、配置键、环境变量
• URL、仓库名、产品名、模型名
• 官方文档中的关键术语，例如 Claude Code、MCP、SDK、Hooks、Skills