Claude Code 子代理精选
130+ subagent 大集合 + 从里面挑出来的 8 个专家 — K8s / SEO / 安全审计 / 智能合约 / GraphQL / API 架构 / 搜索 / Prompt 工程师。
这个 pack 装了什么
Claude Code 的 subagent 是 .claude/agents/ 目录下的 markdown 文件,每个定义一个专注的专家。任务匹配时宿主自动派发其中一个 —— 让你用一堆小而专的 agent 拼出长流程,而不是写一份巨型 CLAUDE.md。2025 年 subagent 生态爆炸式增长,这个 pack 给你一个挑选过的切入点。
| # | 资产 | 干什么 |
|---|---|---|
| 1 | awesome-claude-code-subagents | 130 agent 参考大集合(VoltAgent 维护) |
| 2 | k8s-specialist | YAML 感知的 Kubernetes 清单 + kubectl 风格 diff |
| 3 | seo-specialist | 站内 SEO 审计、结构化数据、meta 描述撰写 |
| 4 | security-auditor | OWASP 视角的代码审查,按严重度分类 |
| 5 | smart-contract-auditor | Solidity / Move 审查重入、权限、Gas |
| 6 | graphql-architect | Schema 设计、联邦、N+1 探测 |
| 7 | api-architect | REST + OpenAPI 设计与版本化模式 |
| 8 | search-specialist | Anthropic 风格的多工具搜索编排 |
| 9 | prompt-engineer | Prompt 改写和自我批判 |
为什么要从 130 里挑
直接克隆完整的 awesome-list 多数工程师会被淹没:130 个 agent 的下拉菜单比没有 agent 更糟。Claude Code 是按 description 匹配最合适的 agent,所以一堆功能重叠的专家只会制造噪音。我们挑了 8 个对应常见生产任务、且专家版明显胜过原版 Claude Code 的。
完整集合仍有价值 —— 遇到冷门需求(Cobol 现代化、Stripe 集成等)先 grep 130 再自己写。但日常工作台就是这 8 个。
一条命令装齐
tokrepo install pack/claude-code-subagents
# 或者只装单个
tokrepo install seo-specialist
tokrepo install security-auditor
tokrepo install graphql-architect
TokRepo CLI 把每个 subagent 写进当前项目的 .claude/agents/<name>.md,下次启动 Claude Code 自动加载。
怎么调用 subagent
不必显式点名。Claude Code 的派发机制读 frontmatter 里的 description,按任务匹配最佳。如果你想强制指定:
> use the security-auditor subagent and review the changes since main
> use the graphql-architect subagent to design a federated schema for our 3 services
这个 pack 不够用怎么办
跟 Boris Cherny Files 配套(拿到流程胶水级 subagent:Ralph Wiggum 循环、code-simplifier、verify-app),或上 Anthropic Builders 拿 17 个官方 skill。
9 个资产打包就绪
常见问题
Claude Code 的 subagent 和 slash 命令有啥区别?
subagent 是带自己系统提示词的专注专家,Claude Code 按任务描述自动派发。slash 命令是带参数的提示词,需要你显式 /name 调用。subagent 用于能力组合;slash 命令用于快捷方式。两者都放在 .claude/ 下,可以一起用。
这 8 个 subagent 在 Claude Code 之外能用吗?
subagent 是 Claude Code 专有抽象。TokRepo CLI 能把它映射到其他工具的最接近等价物 —— Cursor .mdc 规则、Codex CLI AGENTS.md 等 —— 但自动派发行为是 Claude Code 独有的。在非 Claude Code 工具里要按名字显式调用。
awesome-claude-code-subagents 是 Anthropic 官方的吗?
是社区项目(VoltAgent),不是 Anthropic 的。Anthropic 自己发过几个官方 subagent(code-simplifier / search-specialist)—— 那些也在 TokRepo 上,单独条目。130 大集合是事实上多数工程师的入门起点。
Claude Code 怎么决定用哪个 subagent?
Claude Code 读每个 subagent frontmatter 里的 description 字段,跟用户任务做匹配。多个匹配时挑最具体的。你可以在 prompt 里写 use the
加 8 个 subagent 会撑爆 context 吗?
不会。subagent 定义只有在被派发时才进 context。放在 .claude/agents/ 里不耗任何 token。130 集合也是同样性质 —— 哪怕装了 130 个,没被调用就不耗 token。