这一类最容易买错:很多人把「多 agent」当成更强的 skill 去装。其实 subagent / hook / slash command / plugin 解决的是四件不搭界的事,选错了不是效果差,是根本不触发。本期先给十条能装的,再给一张两轴坐标把它们各自钉死。
别的类别装错了至少还会跑,编排类装错了通常是静悄悄地不生效——「每次提交前跑 lint」写进 CLAUDE.md,模型十次忘三次;需要判断的活写成 hook,它每次都硬邦邦地拦错人。正确用法只有一句:需要判断的交给模型,不需要判断的交给代码,会淹没上下文的挪出去,要给别人用的打成包。本期点名十条真实可装/可读的条目,先给表和命令,判据放后半程。
# ⑥⑦⑧ 官方市场,首次启动交互式会话时自动添加;没有就手动加
/plugin marketplace add anthropics/claude-plugins-official
/plugin install security-guidance@claude-plugins-official
/plugin install hookify@claude-plugins-official
/plugin install feature-dev@claude-plugins-official
# ⑤ agent teams 默认关闭,在 settings.json 的 env 里开
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }
# ⑨ 社区最大的一个 marketplace,同样是 /plugin 两步
/plugin marketplace add wshobson/agents
/plugin install python-development # 或它 94 个插件里的任意一个
# ① subagent 就是一个带 frontmatter 的 md 文件,不用装
# .claude/agents/reviewer.md —— name 与 description 是仅有的两个必填字段
# 装完立刻做这两件事
/plugin # Installed 页有 “Not used recently” 分组,直接告诉你谁在白拿钱
/skill-doctor # 看每个 skill 的 context 成本
.claude/agents/*.md,只有 name 和 description 必填,其余如 tools / disallowedTools / model / maxTurns / permissionMode / isolation: worktree 都是可选。全部价值在独立上下文窗口:翻日志、扫全仓这种会冲垮主对话的活扔进去,只把结论拿回来。官方硬数:默认最多 20 个并发(CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 可调)、最多嵌套 3 层、所有 agent 的 description 加起来超过 15,000 token 会在启动时告警。什么时候别用:结果本来就只有一句话——多开一个上下文纯属交税。hooks 块,生命周期到点就跑你的 shell 命令。这是本类唯一确定性的机制——不靠模型「记得」。官方事件表已铺得很开:PreToolUse / PostToolUse / PostToolUseFailure / PostToolBatch / UserPromptSubmit / PermissionRequest / PermissionDenied / SubagentStart / SubagentStop / Stop / TeammateIdle / TaskCreated / TaskCompleted / InstructionsLoaded / ConfigChange / FileChanged / PreCompact / SessionStart / SessionEnd 等。两条硬规矩:PreToolUse 的 deny 在 bypassPermissions 与 --dangerously-skip-permissions 下依然生效(能收紧、不能放宽);同一事件的多个 hook 并行跑完才合并,一个 deny 不阻止另一个的副作用。什么时候别用:这件事需要判断——改用 type: "prompt"(单轮)或 type: "agent"(多轮、默认 60 秒超时、最多 50 轮,官方标注实验性)。.claude/skills/<name>/SKILL.md(多文件、热重载),老式 .claude/commands/<name>.md 仍支持但只能单文件。决定「谁能触发」的是两个 frontmatter 字段:disable-model-invocation: true = 只有你能敲(适合 /deploy 这种),user-invocable: false = 只有模型能用。三个被低估的能力:!`命令` 在模型看到内容之前就把 shell 输出灌进去、allowed-tools 在这一轮预批权限、context: fork 把这条命令扔进隔离子会话跑。什么时候别写:只做一次的活。.claude-plugin/plugin.json 的目录,把 skills / agents / hooks / MCP servers 打成一个安装单元。它不是第五种能力,是运输箱。官方把代价写得很直白:启用的插件对每个会话都生效,不只是你用到它那次——凡是模型能自己调用的 skill / agent / command,名字与描述每一轮都在 context 里。装前看 /plugin 的 Context cost,装后看 Not used recently。什么时候别打包:只有你一台机器用,直接放 ~/.claude/。/resume 恢复不了 in-process teammate)· 不能嵌套(teammate 不能再开 teammate)· 一个会话只能有一个团队 · lead 不能转让 · 关机慢 · 任务状态会滞后。官方建议 3–5 个起步,并明说「三个专注的常常打得过五个散的」。PostToolUse 抓 Edit/Write 做纯字符串模式匹配(eval(、pickle、dangerouslySetInnerHTML、动了 .github/workflows/ 等,不调模型、零成本);Stop 在每轮结束后台跑一次 diff 复审(每轮最多 30 个改动文件,最多连开三次);PostToolUse 过滤 git commit/git push 再跑一次会读上下文的 agentic 复审(每滚动小时最多 20 次)。关键设计:不让写代码的那个实例自己打分,而是另起一个只被告知「找问题」的 Claude。诚实交代:三层都不阻断写入或提交,只把发现塞回去让它改。/hookify [描述] 从你的一句话、或直接从这段对话里找出你烦了的行为,生成一条带 YAML frontmatter 的 markdown 规则(event / pattern / action: warn|block),改完不用重启,下一次工具调用就生效;另有 /hookify:list 与 /hookify:configure 管开关。什么时候别装:你已经会手写 hooks 配置——那它只是多一层抽象。/feature-dev 命令拉起七阶段流水线,里面挂三个分工明确的 agent——code-explorer(顺执行路径摸清现状)、code-architect(出架构与实现蓝图)、code-reviewer(查 bug 与项目约定)。值得单看的是分工方式:勘探、设计、审查各自独立上下文,谁都不替另一个背书。同市场还有 code-review(PR 级多 agent 评分)与 claude-code-setup(扫一遍你的库,反过来告诉你该配什么自动化)。什么时候别用:改一行的活。@claude 提及 / 明确 prompt / PR 审查自动选模式,最小工作流要 contents: write、pull-requests: write、issues: write 三个权限——给 CI 开写权限之前请先想清楚。davila7/claude-code-templates 用 npx claude-code-templates@latest 挑装 agent / command / hook / MCP 组件。ruvnet/ruflo(原 claude-flow,MIT)是另一个极端——自述 100+ agent、swarm 拓扑与共识机制,它不是「装一个插件」,是换一套 harness;本期不推荐,配置面远大于多数人要解决的问题。最常见的三种错配,全都能从这张表上一眼看出来:
CLAUDE.md,等于把右下角那格的活塞进中间那格——它变成一条模型可以忘的建议。它该是一条 PostToolUse hook,或用 ⑦ 一句话生成。type: "prompt" 的单轮判断,或抄 ⑥——用 Stop hook 在后台另起一个 Claude 复审再回灌。还有一条容易忽略:开了 ⑤ 之后普通委派也会变。官方原文——启用期间模型自己给 subagent 起了名字就会把它作为 teammate 拉起来,你没要求组队也可能组出团队。不想要就把 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 设回 0。
CLAUDE.md 的是建议,不是保证。description 要写清「什么时候用我」。不要 → disable-model-invocation: true,别让它自作主张跑 /deploy。/skill-doctor。① 另有一条:所有 agent description 合计超 15,000 token 会告警。~/.claude/。一个仓库 → .claude/ 提交进去。跨仓库或跨团队 → 才值得做成 ④,配一个 marketplace。PreToolUse 的 Bash 匹配是尽力而为的,官方明说「硬性 allow/deny 请用 permission 系统,不要用 hook」。subagentPromptCacheTtl 可调 1h,但 1 小时缓存写入计费更高)。权限上还有一条:lead 用 --dangerously-skip-permissions 起,所有 teammate 都跟着。PostToolUse 能解决的事。不会写就用 ⑦。先装这三个:① /plugin install security-guidance@claude-plugins-official——零配置、模式匹配层不花钱,而且它本身就是最好的 hook 编排范本。② /plugin install hookify@claude-plugins-official——你的第一条 hook 用它写,改完不重启就生效。③ 一个你自己的 .claude/agents/ 文件(name 与 description 两个字段就够),把最常淹没上下文的那件事挪出去。
按需再加:feature-dev@claude-plugins-official(做整块功能,接受七阶段的开销)· code-review@claude-plugins-official(要 PR 级多 agent 评分)· claude-code-setup@claude-plugins-official(不知道该配什么,让它扫一遍你的库)· wshobson/agents(缺某个特定角色,按插件取,不整仓装)· disler/claude-code-hooks-mastery(要抄 hook 范例,事件名回官方文档核)· anthropics/claude-code-action(要把这套搬进 CI)。
明确别做:把「每次都要做」的事写进 CLAUDE.md 而不是 hook · 把需要判断的事写成硬 deny hook · 同一件事装两个 reviewer · 只有自己一台机器还费劲打成 plugin · 没读限制清单就在生产分支上开 agent teams · 以为 agent 数量越多编排越强——官方原话是「三个专注的常常打得过五个散的」。
.claude/agents/*.md 定义的助手,跑在自己的上下文窗口里,只把结果交回调用者。默认最多 20 并发、最多嵌套 3 层。.claude-plugin/plugin.json 的目录,把 skills / agents / hooks / MCP servers 打成一个安装单元。它是运输箱,不是第五种能力。/plugin 里官方市场插件详情页显示的常驻上下文估算。装之前就该看的那个数。/deploy 这类命令用。$ARGUMENTS、!`命令`、allowed-tools、context: fork(2026-09)CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS;3–5 人建议;完整限制清单(2026-09)security-guidance / hookify / feature-dev / code-review / claude-code-setup 的名字与作者均以此处 marketplace.json 为准(2026-09)agents/ 下的 code-explorer / code-architect / code-reviewer;/feature-dev 七阶段流程/hookify / :list / :configure;markdown + YAML frontmatter 规则;action: warn|blockcontents / pull-requests / issues 三个 write 权限(MIT)description 怎么写,完整在那期