Appearance
1.7万星claude-code-best-practice:Claude Code工作流指南
这不是教你几条 Claude Code 小技巧的仓库,而是教你怎么把 Claude Code 组织成一套可复用、可协作、可持续迭代的工作流。
项目卡片
| 项目 | 信息 |
|---|---|
| 项目名 | claude-code-best-practice |
| GitHub | https://github.com/shanraisshan/claude-code-best-practice |
| 一句话 | 教你怎么把 Claude Code 组织成稳定流程 |
核心架构:入口层是 command,执行层是 agent / subagent,复用层是 skill、settings、memory 和 MCP。
解决什么问题?
很多人真正卡住,不是不会用 Claude Code,而是进入真实项目后遇到三个问题:
| 问题 | 说明 |
|---|---|
| 上下文混乱 | 所有规则、背景、临时需求都塞进一个会话,越聊越钝 |
| 职责混乱 | command、skill、agent、settings、memory、MCP 各自该干什么,没有边界 |
| 流程失控 | 同样一类任务每次都重讲一遍,无法复用,也很难协作 |
六层分工边界
| 层级 | 用途 | 说明 |
|---|---|---|
| command | 入口、触发词、固定流程包装 | 一句话拉起一套动作 |
| skill | 可复用的方法、步骤、判断标准 | 反复用到的经验沉淀 |
| agent / subagent | 重任务、长任务、独立上下文 | 不要把复杂活都塞在主会话里 |
| settings | 稳定规则和全局偏好 | 长期遵守的约束,不必每次重讲 |
| memory | 持续性背景和长期记忆 | 「这件事以后也得记得」 |
| MCP | 接入外部工具、数据源和系统能力 | 有没有进入你的日常流程 |
分工一旦清楚,Claude Code 才会从「能聊」变成「能跑流程」。
适合谁?
适合
- 已经在用 Claude Code,但开始遇到上下文混乱、职责混乱、流程失控的人
- 想把 Claude Code 从「会用」推进到「能稳定用于真实项目」的人
- 希望把自己的经验整理成 command / skill / agent 分工的人
不太适合
- 只是想看基础命令和快速入门的人
- 还没进入真实项目、暂时不需要流程设计的人
- 当前只想偶尔让 AI 改个小 bug,不关心复用和协作的人
最短上手闭环
| 步骤 | 动作 |
|---|---|
| 1 | 挑一个经常重复的任务,不要一上来就重构全部流程 |
| 2 | 把任务入口收成一个 command,让触发方式固定下来 |
| 3 | 把会重复解释的方法写成 skill,别每次重新讲背景和步骤 |
| 4 | 把又长又重的执行过程切给 subagent,主会话留给判断和调度 |
| 5 | 把稳定规则放进 settings / memory,把外部能力接到 MCP 里 |
做到这一步,你就不是「在和 Claude Code 聊天」,而是在搭一个能持续复用的工作流。
总结
这个仓库的价值:教你怎么给 Claude Code 做分工、做组织、做工作流,而不只是补几个技巧。
| 层级 | 放什么 |
|---|---|
| command | 入口触发 |
| skill | 方法复用 |
| agent | 重任务执行 |
| settings | 全局规则 |
| memory | 长期记忆 |
| MCP | 外部能力 |
理顺以后,Claude Code 才能从偶尔好用的助手,变成能长期参与真实项目的协作系统。
关键词:claude-code-best-practice, Claude Code工作流, command skill agent, MCP分工, 工作流设计
