claude-code-kit

一份用得起来的 Claude Code 配置——skills、hooks、slash commands、sub-agents、settings 全套——把它从一个聊天助手推向一个更像自治编程系统的东西。我自己整个工作流都跑在它上面。这一页是一个简短的导览。

前提

开箱的 Claude Code 在「问 → 写 → 跑 → 迭代」这个内循环里非常好用。但它在循环之外的事情上能力一般：跨天的项目规划、跨会话的上下文持久化、结构化的 PR review、把 TODO 和 PROGRESS.md 同步着维护、判断什么时候该停下来问、什么时候该自己往下推。

这些 gap 大部分可以用 SDK 已经给的几块原语补上——Skill（领域特定的微指令集）、Hook（生命周期事件触发的 shell 命令）、slash commands、sub-agents。这个 kit 不过是我对怎么把它们串起来的一种偏见。

里面有什么

Slash commands。 我每天都在用的几条：

• /loop — 跑目标驱动的迭代：supervisor 规划任务，workers 通过 batch-tasks 并行执行，反复直到某个 stop condition 触发。适合那种「把这个模块的测试覆盖率改到 80%」——开放式但可验。
• /handoff — 把会话状态（未解决的问题、刚才试了什么、下一步是什么）保存成一份 markdown，让下一个会话或者一个并行 agent 可以从断点接着做。
• /pickup — /handoff 的逆操作。读上一份 handoff、自己 refresh、必要时问一个澄清问题、继续。
• /review-pr — 拉一个 PR 的 diff，跑一份结构化 review（correctness / security / readability / tests），作为一条 GitHub 评论 post 出去。
• /sync — 一天结束的时候过一遍 diff，更新 TODO.md 和 PROGRESS.md，这样明天不会冷启动。
• /incident — 切到事故响应模式：先诊断、写 postmortem、再补 follow-up。

Skills。 比 slash commands 小。它们是只在相关时激活的领域知识——claude-api 在 Anthropic SDK 代码出现的时候触发，tdd-workflow 在测试先行的 feature 上触发，security-review 在 auth / payments 代码上触发，e2e-testing 在 Playwright 项目上触发。意义在于不撑大系统提示——按需加载。

Hooks。 Stop hook 在 agent 结束前检查工作是不是只做了一半。UserPromptSubmit hook 扫描用户的纠正，把它们写进 ~/.claude/corrections/rules.md——一份会随着周累计的学习文件。还有一个 PostToolUse hook，每次 edit 之后自动跑 typecheck。

Sub-agents。 Explore 用来扫代码库，code-reviewer、test-runner、type-checker、verify-app 各管一段。每一个都是被别的 agent 使用的专注工具——主上下文保持干净。

实际怎么用

我的日常大概是：

1. /pickup（接昨天的会话）
2. 推进 TODO 里的下一项——通常先 Plan 再实现
3. 提交前 /review-pr
4. 一天结束 /sync
5. 要切上下文之前 /handoff

更长跨度的工作（几周的项目），/loop 在会话之间自治地批量推进；我一天 check 一次、重定向、继续跑。

为什么开源

Claude Code 是我用得最多的工具，没有之一。经常有人问我配置是怎么样的。现在我可以说：「看 repo」。它同时是一个 hedge——哪天笔记本坏了，三条命令就能在新机器上把整套工作流重搭起来。

克隆

git clone https://github.com/Waaangjl/claude-code-kit ~/.claude

（是的，它直接 clone 到你的 ~/.claude。如果你已经有在意的配置，先读一下 README。）

仓库：github.com/Waaangjl/claude-code-kit ↗