from vibe coding to agentic engineering — practice makes claude perfect
= Agents ·
= Commands ·
= Skills

Boris Cherny 在 X 上(tweet 1 · tweet 2 · tweet 3)
💡 想把这个仓库真正用透,先读下面的「如何使用」一节。
🧠 概念
| 功能 | 位置 | 说明 |
|---|---|---|
.claude/agents/<name>.md | ||
.claude/commands/<name>.md | ||
.claude/skills/<name>/SKILL.md | ||
| Workflows | .claude/commands/weather-orchestrator.md | |
| Hooks | .claude/hooks/ | |
| MCP Servers | .claude/settings.json, .mcp.json | |
| Plugins | 可分发的包 | 插件市场 · 创建插件市场 |
| Settings | .claude/settings.json | |
| Status Line | .claude/settings.json | |
| Memory | CLAUDE.md, .claude/rules/, ~/.claude/rules/, ~/.claude/projects/<project>/memory/ | |
| Checkpointing | 自动(文件编辑追踪) | |
| Sessions | --resume, --continue, /resume, /branch | |
| Context Window | /compact, /clear, /context | |
| CLI Startup Flags | claude [flags] | |
| AI Terms | ||
| Best Practices | Prompt Engineering · 扩展 Claude Code | |
| Prompt Library |
🔥 热点
| 功能 | 位置 | 说明 |
|---|---|---|
| Ultrareview | /code-review ultra, claude ultrareview [target] | 任务追踪 |
| Devcontainers | .devcontainer/ | |
| Channels | --channels,基于插件 | 参考文档 |
| No Flicker Mode | /tui fullscreen, CLAUDE_CODE_NO_FLICKER=1 | |
| Auto Mode | --permission-mode auto, Shift+Tab | |
| Power-ups | /powerup | |
| Fast Mode | /fast, "fastMode": true | |
| Advisor | /advisor, advisorModel, --advisor | 博客 |
| Computer Use | computer-use MCP server | 桌面版 |
| Agent SDK | npm / pip 包 | 快速上手 · 示例 |
| Ralph Wiggum Loop | 插件 | |
| Chrome | --chrome,浏览器扩展 | |
| Claude Code Web | claude.ai/code | Routines |
| Artifacts | /share, Artifact 工具 | |
| Slack | Slack 里的 @Claude | |
| Code Review | GitHub App(托管) | |
| GitHub Actions | .github/workflows/ | GitLab CI/CD |
| Remote Control | /remote-control, /rc | |
| Deep Links | claude-cli://open?repo=…&q=… | |
| Dynamic Workflows | /workflows, ultracode 关键字, /effort ultracode, .claude/workflows/ | Deep Research |
| Agent Teams | 内置(环境变量开关) | |
| Agent View | claude agents, --bg, /bg | |
| Cross-Session Messaging | SendMessage, ListAgents, /list-agents | |
| Scheduled Tasks | /loop, /schedule, cron 工具 | |
| Routines | claude.ai/code/routines, /schedule | 桌面版任务 |
| Tasks | /tasks, ~/.claude/tasks/ | |
| Goal | /goal <condition>, /goal clear | |
| Voice Dictation | /voice | |
| Bundled Skills | /code-review, /batch | |
| Git Worktrees | --worktree/-w, .worktreeinclude, EnterWorktree/ExitWorktree, isolation: "worktree", WorktreeCreate/WorktreeRemove hooks |
编排工作流
Command →
Agent →
Skill 模式的实现细节见 orchestration-workflow。
claude
/weather-orchestrator
⚙️ 开发工作流
主流工作流最后都收敛到同一个架构模式:Research → Plan → Execute → Review → Ship
| 名称 | ★ | 工作流 | |||
|---|---|---|---|---|---|
| Superpowers | 291k | 0 | 0 | 15 | |
| Matt Pocock Skills | 269k | 0 | 0 | 38 | |
| Everything Claude Code | 267k | 68 | 147 | 292 | |
| Spec Kit | 139k | 0 | 10 | 0 | |
| gstack | 134k | 0 | 0 | 53 | |
| agent-skills | 89k | 3 | 7 | 21 | |
| OpenSpec | 70k | 0 | 12 | 12 | |
| Get Shit Done | 64.6k | 33 | 97 | 0 | |
| BMAD-METHOD | 53k | 0 | 0 | 32 | |
| oh-my-claudecode | 39.3k | 19 | 21 | 43 | |
| Compound Engineering | 25.3k | 0 | 1 | 36 | |
| HumanLayer | 11.6k | 6 | 27 | 0 |
注:黄色标签是子循环——在父步骤内部重复的步骤(如逐任务、逐 story,或直到验证条件通过)。
其他
- RPI
- Ralph Wiggum Loop
- Andrej Karpathy(OpenAI 创始成员)的工作流
- Peter Steinberger(OpenClaw 作者)的工作流
- Boris Cherny(Claude Code 创造者)的工作流——13 条技巧 · 10 条 · 12 条 · 2 条 · 15 条 · 6 条
- Thariq(Anthropic)的工作流——Skills · 会话管理
🔀 跨模型工作流
让 Claude Code 与其他模型协同——Codex、Gemini、GPT、Kimi、DeepSeek、本地模型——有三条路:
- Plugin——别家模型的 CLI 跑进 Claude Code 里(斜杠命令如
/codex:review) - MCP——Claude Code 通过 Model Context Protocol 把别家模型当工具调
- Router——把 Claude Code 的 API 端点换到别家 provider
方法论:跨模型(Claude Code + Codex)工作流 ——手动双终端:Claude 出计划,Codex 做 QA 评审。
| 名称 | ★ | 类型 | 桥接 | 干什么 |
|---|---|---|---|---|
| musistudio/claude-code-router | 34k | Router | OpenRouter, DeepSeek, Ollama, Gemini, Kimi, Qwen, Groq 等 | 把 Claude Code 的 API 路由到任何兼容 provider,按任务选模型 |
| router-for-me/CLIProxyAPI | 32k | Router | Gemini CLI, Codex, Claude Code, Antigravity | 把各家 CLI 包装成 OpenAI/Gemini/Claude/Codex 兼容的 API 服务 |
| openai/codex-plugin-cc | 18k | Plugin | Codex / GPT-5 | OpenAI 官方插件:在 Claude Code 里用 /codex:review、/codex:adversarial-review、/codex:rescue |
| BeehiveInnovations/pal-mcp-server | 12k | MCP | Gemini, OpenAI, Azure, Grok, Ollama, OpenRouter(50+ 模型) | 多模型 MCP server(前身 zen-mcp-server)——把其他模型当 Claude 的工具调 |
🧰 技能合集
以 SKILL.md 文件库闻名的仓库(区别于上面整套工作流方法论)。按 star 降序。
| 名称 | ★ | |
|---|---|---|
| mattpocock/skills | 269k | 38 |
| anthropics/skills | 178k | 19 |
| Egonex-AI/Understand-Anything | 67k | 8 |
| scientific-agent-skills | 46k | 166 |
| wshobson/agents | 40k | 183 |
| awesome-agent-skills | 35k | 1,497+(精选清单) |
| impeccable | 27k | 1(另附 7 个设计领域参考) |
| agent-skills | 27k | 21 |
| claude-skills | 15k | 246(跨 9 个领域) |
| shanraisshan/draw-json-architecture-skill | 3 | 1 |
🤖 Agent 合集
以 subagent 定义库(.claude/agents/*.md)闻名的仓库。按 star 降序。
| 名称 | ★ | |
|---|---|---|
| msitarzewski/agency-agents | 154k | 279 |
| VoltAgent/awesome-claude-code-subagents | 25k | 158 |
💡 技巧与窍门(83)
🚫👶 = 不用盯着
提示词 · 规划 · 上下文 · 会话 · CLAUDE.md + .claude/rules · Agents · Commands · Skills · Hooks · Workflows · Workflows 进阶 · Git / PR · 调试 · 实用工具 · 日常
■ 提示词(3)
■ 规划 / 规格(7)
| 技巧 | 出处 |
|---|---|
| 永远从 plan mode 开始 | |
| 从一份最小的 spec 或 prompt 起步,让 Claude 用 AskUserQuestion 工具反过来采访你;然后再开一个新会话去执行 spec | |
| 计划要按阶段设闸门,每个阶段配多种测试(单元、自动化、集成) | |
| 把 PRD 拆成贯穿所有层的垂直切片(tracer bullets,DB + service + UI)——AI 默认按水平分层推进(先 DB,再 API,再前端),端到端反馈被拖到最后一阶段才出现。出自《程序员修炼之道》 🚫👶 | |
| 再开一个 Claude,让它以 staff engineer 的姿态审你的计划,或者用跨模型方案来审 | |
| 交接之前把 spec 写细、把歧义挤掉——你说得越具体,产出越好 | |
| 原型 > PRD——与其写 spec,不如做 20–30 个版本;构建成本低,多打几枪 |
■ 上下文(5)
| 技巧 | 出处 |
|---|---|
| 1M 上下文模型上,context rot 大约在 30–40 万 token 开始出现——对智力敏感的任务,别让会话飘过这条线 | |
| 笨拙区大约在 40% 上下文占用时出现——“你会碰到一个产出明显退化的点”。新手:“尽量压在 40% 以下,到 60% 就该考虑收尾了”。老手:“激进地压在 30% 以下”——只有简单任务才推到 60%。切任务时手动 /compact 或 /clear 复位 | |
| rewind 优于打补丁——双击 Esc 或 /rewind 回到失败尝试之前,带着新学到的教训重新 prompt,而不是让失败加修正堆在上下文里 🚫👶 | |
| 带提示的 /compact(如 /compact focus on the auth refactor, drop the test debugging)比等自动 compact 强——自动 compact 触发时,模型正处在 context rot 之下最不聪明的时刻 | |
| 用 subagent 管上下文——问自己”这个工具输出我还要复用吗,还是只要结论?“——20 次读文件、12 次 grep、3 条死路都留在子上下文里,回来的只有最终报告 🚫👶 |
■ 会话管理(6)
| 技巧 | 出处 |
|---|---|
| 每一轮都是一个分岔口——Claude 结束一轮后,按”要带走多少现有上下文”在 Continue、/rewind、/clear、/compact、Subagent 之间选 | |
| 新任务 = 新会话——相关任务(比如给刚写完的东西补文档)可以复用上下文省事,真正的全新任务值得一个干净的会话 | |
| rewind 之前先说 “summarize from here”,让 Claude 写一份交接信息——像未来的 Claude 给上一版自己留的条 | |
| /compact 与 /clear——compact 有损但保节奏(任务中途,细节模糊点无所谓);/clear 加一段简报更费事,但带走什么由你精确控制(下一步 stakes 高时用它) | |
| 长会话开 recaps——Claude 做了什么、下一步是什么的短摘要,离开几分钟或几小时再回来时有用。在 /config 里可关 | |
| 给重要会话 /rename(比如 [TODO - refactor task]),之后 /resume 回来——同时跑多个 Claude 时,给每个实例都贴上标签 |
■ CLAUDE.md + .claude/rules(8)
| 技巧 | 出处 |
|---|---|
| CLAUDE.md 每个文件控制在 200 行以内;humanlayer 用的是 60 行(即便这样也不保证 100% 被遵守) | |
| .claude/rules/*.md 像 CLAUDE.md 一样自动进每个会话——在 YAML frontmatter 里加 paths:,只有 Claude 碰到匹配 glob 的文件时才加载 | |
| 给领域相关的 CLAUDE.md 规则套上 <important if=”…”> 标签,文件变长后防止 Claude 无视它们 | |
| monorepo 用多份 CLAUDE.md——祖先目录加子孙目录叠加加载 | |
| 大块指令拆进 .claude/rules/ | |
| 任何一个开发者打开 Claude 说 “run the tests”,第一次就该能跑通——跑不通,说明 CLAUDE.md 缺了必要的 setup/build/test 命令 | |
| 代码库保持干净,迁移要做完——迁了一半的框架会把模型带偏,它可能挑错模式 | |
| harness 强制的行为(署名、权限、模型)交给 settings.json——既然 attribution.commit: "" 是确定性生效的,就别在 CLAUDE.md 里写 “NEVER add Co-Authored-By” |
Agents(4)
| 技巧 | 出处 |
|---|---|
| 要领域专属的 sub-agent(额外上下文)配 skill(渐进式披露),别搞通用 qa、backend engineer | |
| 说一句 “use subagents” 就是给问题加算力——把任务卸载出去,主上下文保持干净聚焦 🚫👶 | |
| agent teams 配 tmux 和 git worktrees,做并行开发 | |
| 用 test time compute——独立的上下文窗口让结果更好;一个 agent 闯的祸,另一个同型号的 agent 找得出来 |
Commands(3)
| 技巧 | 出处 |
|---|---|
| 自己的工作流用 command,而不是 sub-agent | |
| 一天要做很多次的”内循环”工作流都做成斜杠命令——省掉重复 prompt;command 放在 .claude/commands/,随 git 提交 | |
| 一天做超过一次的事,就把它变成 skill 或 command——去做 /techdebt、context-dump、analytics 这类命令 |
Skills(9)
| 技巧 | 出处 |
|---|---|
| 用 context: fork 让 skill 跑在隔离的 subagent 里——主上下文只看到最终结果,看不到中间的工具调用。agent 字段可以指定 subagent 类型 | |
| monorepo 把 skill 放子目录 | |
| skill 是文件夹不是单个文件——用 references/、scripts/、examples/ 子目录做渐进式披露 | |
| 每个 skill 里建一节 Gotchas——信号密度最高的内容,把 Claude 踩过的坑持续补进去 | |
| skill 的 description 字段是触发器不是摘要——写给模型看(“我什么时候该被触发?”) | |
| skill 里别写正确的废话——聚焦能把 Claude 推出默认行为的内容 🚫👶 | |
| skill 里别给 Claude 铺铁轨——给目标和约束,不给一步一步的处方 🚫👶 | |
| skill 里带上脚本和库,让 Claude 做组合,而不是重新发明样板 | |
| 在 SKILL.md 里嵌 !command,把动态 shell 输出注入 prompt——调用时 Claude 执行它,模型只看到结果 |
■ Hooks(5)
| 技巧 | 出处 |
|---|---|
| skill 里用按需 hook——/careful 拦危险命令,/freeze 拦目录外的编辑 | |
| 用 PreToolUse hook 统计 skill 的使用情况,找出高频的和触发不足的 | |
| 用 PostToolUse hook 自动格式化——Claude 生成的代码已经够规整,hook 收掉最后 10%,免得 CI 挂 | |
| 用 hook 把权限请求转给 Opus——让它扫一遍有没有攻击,安全的自动放行 🚫👶 | |
| 用 Stop hook 在一轮结束时推 Claude 一把,让它继续或验证自己的产出 |
■ Workflows(5)
| 技巧 | 出处 |
|---|---|
| 用 /model 选模型与推理档,/context 看上下文占用,/usage 查套餐额度,/extra-usage 配置超额计费,/config 改设置——plan mode 用 Opus、写码用 Sonnet,两头的好处都拿到 | |
| 在 /config 里始终开 thinking mode(看推理过程),Output Style 用 Explanatory(看带 ★ Insight 框的详细输出),Claude 的决策更容易看懂 | |
| prompt 里写 ultrathink 关键词,换高档推理 | |
| /focus 模式藏掉所有中间过程,只给最终结果——相信模型会跑对命令,只看产出(用 /focus 切换) | |
| 用 Opus 4.7 的自适应思考调 effort——low 要速度省 token,max 要智力拉满(档位:low · medium · high · xhigh · max) |
■ Workflows 进阶(9)
| 技巧 | 出处 |
|---|---|
| 多用 ASCII 图来理解自己的架构 | |
| /loop 做本地周期监控(最长 7 天);/schedule 做云端周期任务,机器关了也照跑 | |
| 长时间自治任务用 Ralph Wiggum 插件 | |
| /permissions 用通配符(Bash(npm run *)、Edit(/docs/**))替代 dangerously-skip-permissions | |
| /sandbox 用文件与网络隔离减少权限弹窗——内部数据降了 84% | |
| 在产品验证 skill 上投资(signup-flow-driver、checkout-verifier)——值得花一周打磨 | |
| 用 auto mode 替代 dangerously-skip-permissions——一个基于模型的分类器判断每条命令是否安全,安全的自动批,有风险停下来问。Shift+Tab 在 Ask → Plan → Auto 之间循环 🚫👶 | |
| 用 /less-permission-prompts skill 扫描会话历史,找出反复弹窗的安全 bash/MCP 命令,生成推荐白名单贴进 settings | |
| 做一个 /go skill:先用 bash/浏览器/computer use 端到端测试,再跑 /simplify,最后开 PR——你回来的时候,就知道代码是好的 🚫👶 |
■ Git / PR(5)
| 技巧 | 出处 |
|---|---|
| PR 保持小而聚焦——p50 是 118 行(一天 141 个 PR、4.5 万行变更);一个 PR 一个功能,好评好回滚 | |
| PR 一律 squash merge——干净的线性历史,一个功能一个 commit,git revert 和 git bisect 都顺手 | |
| 勤提交——至少每小时一次;任务一完成就 commit | |
| 在同事的 PR 上标 @claude,让它把反复出现的 review 意见自动生成为 lint 规则——把自己从 code review 里自动化出去 🚫👶 | |
| 用 /code-review 做多 agent 的 PR 分析——合并前抓住 bug、安全漏洞和回归 |
■ 调试(6)
| 技巧 | 出处 |
|---|---|
| 卡住就截图给 Claude,养成习惯 | |
| 用 MCP(Claude in Chrome、Playwright、Chrome DevTools)让 Claude 自己去看 Chrome 控制台日志 | |
| 想看哪个终端的日志,就让 Claude 把它作为后台任务跑——调试体验更好 | |
| /doctor 诊断安装、认证与配置问题 | |
| QA 用跨模型——比如 Codex 来审计划和实现 | |
| agentic 搜索(glob + grep)胜过 RAG——Claude Code 试过向量数据库又放弃了:代码会漂移失步,权限又复杂 |
■ 实用工具(5)
| 技巧 | 出处 |
|---|---|
| 终端用 iTerm/Ghostty/tmux,不用 IDE(VS Code/Cursor) | |
| 语音 prompt 用 /voice 或 Wispr Flow(10 倍效率) | |
| claude-code-hooks,给 Claude 加反馈提示 | |
| status line——随时感知上下文占用,快速 compact | |
| 翻翻 settings.json 里的功能,比如 Plans Directory、Spinner Verbs,调出顺手的手感 |
■ 日常(2)
| 技巧 | 出处 |
|---|---|
| 每天更新 Claude Code | |
| 每天开工先读 changelog |
文章 / 推文
来自 Claude Code CLI 二进制的技巧
Spinner Verbs & Tips(从 CLI 二进制 v2.1.121 提取)
🎬 视频 / 播客
| 视频 / 播客 | 出品 | YouTube |
|---|---|---|
| From Vibe Coding to Agentic Engineering (Andrej) | 2026-05-02 | AI Engineer | YouTube | |
| Full Walkthrough: Workflow for AI Coding (Matt) | 2026-04-24 | Matt Pocock | YouTube | |
| Everything We Got Wrong About Research-Plan-Implement (Dex) | 2026-03-24 | MLOps Community | YouTube | |
| Building Claude Code with Boris Cherny (Boris) | 2026-03-04 | The Pragmatic Engineer | YouTube | |
| Head of Claude Code: What happens after coding is solved (Boris) | 2026-02-19 | Lenny’s Podcast | YouTube | |
| Inside Claude Code With Its Creator Boris Cherny (Boris) | 2026-02-17 | Y Combinator | YouTube | |
| Boris Cherny (Creator of Claude Code) On What Grew His Career (Boris) | 2025-12-15 | Ryan Peterman | YouTube | |
| The Secrets of Claude Code From the Engineers Who Built It (Cat) | 2025-10-29 | Every | YouTube |
🔔 订阅
☠️ 创业公司与替代品
十亿美元问题
有答案的话,写信到 shanraisshan@gmail.com。
记忆与指令(4)
- CLAUDE.md 里到底该放什么,不该放什么?
- 已有 CLAUDE.md 的情况下,单独的 constitution.md 或 rules.md 真的有必要吗?
- CLAUDE.md 多久更新一次?怎么知道它已经过时?
- 为什么 Claude 还是会无视 CLAUDE.md 里的指令——哪怕写的是全大写的 MUST?(reddit)
Agents、Skills 与 Workflows(6)
- 什么时候用 command、agent、skill,什么时候原装 Claude Code 反而更好?
- 模型在进步,agents、commands、workflows 该多久跟着更新一次?
- subagent 要通才还是领域/角色专属?给 subagent 一份详细人设能不能提质?做研究/视觉的”完美人设 prompt”长什么样?
- 靠 Claude Code 内置的 plan mode,还是自建一个能贯彻团队流程的 planning command/agent?
- 有了自己的 skill(比如带个人风格的 /implement),怎么引入社区 skill(比如 /simplify)不打架?冲突时谁说了算?
- 到那一步了吗——把现有代码库转成 spec,删掉代码,让 AI 只凭 spec 复原出一模一样的代码?
规格与文档(3)
- 仓库里每个功能都该有一份 markdown spec 吗?
- spec 多久更新一次,才不会在新功能落地后变成废纸?
- 实现新功能时,怎么处理它对其他功能 spec 的连带影响?
🤔 代码还重要吗?
报告
如何使用
照下面几步走,把这个仓库的价值榨干:
- 把它当课程读,不要当 workflow 或 skill 装。 它首先是参考资料;跑是后面的事。
- 别把 Claude 当聊天机器人。 学原语——agents、commands、skills、hooks——组装成你自己的工作流。
- 跑一遍
/weather-orchestrator,看一条完整的 command → agent → skill 链路。把它当模板,套进任何开发流程,从规划到发布。 - 干活时留意自定义 hook 的提示音。 实现在专门的 Claude Code Hooks 仓库;其他模式(如 Agent Teams)在本仓库
implementation/目录里。 - 进阶主题看 🔥 热点那张子表——比如 Ralph Wiggum 自进化循环是一个完整可克隆的仓库,能看到这类模式从头到尾长什么样。
- 在你自己的项目里,让 Claude 读「技巧与窍门」那节并提修改建议——尤其是怎么重组你的
CLAUDE.md。每条技巧都来自 Claude 团队或社区,带出处。 - 订阅「订阅」一节里的 Reddit 和 YouTube 频道,跟上社区。
🎬 视频
📊 演讲

✨2026 年 3 月登上 GitHub Trending✨
Star History
其他仓库
|
Claude Code Hooks |
Codex CLI Best Practice |
Codex CLI Hooks |
Gemini CLI Best Practice |
Gemini CLI Hooks |
开发者
# Workflow 说明 1 /workflows:development-workflows 并行调研全部 10 个工作流仓库,更新 DEVELOPMENT WORKFLOWS 表与跨工作流分析报告 2 /workflows:skill-collections 并行调研全部 5 个技能合集仓库,更新 SKILL COLLECTIONS 表 3 /workflows:agent-collections 并行调研全部 agent 合集仓库,更新 AGENT COLLECTIONS 表 4 /workflows:best-practice:workflow-concepts 跟进 Claude Code 最新功能与概念,更新 README 的 CONCEPTS 一节 5 /workflows:best-practice:workflow-claude-settings 跟踪 settings 报告的变更,找出需要更新的内容 6 /workflows:best-practice:workflow-claude-subagents 跟踪 subagents 报告的变更,找出需要更新的内容 7 /workflows:best-practice:workflow-claude-commands 跟踪 commands 报告的变更,找出需要更新的内容 8 /workflows:best-practice:workflow-claude-skills 跟踪 skills 报告的变更,找出需要更新的内容
附加链接
赞助作者
这个仓库帮到你的话,请我喝杯 doodh pati(奶茶)🍵:
想把品牌放到页头? 页头位置有偿开放——邮件 shanraisshan@gmail.com。