Claude Code 生态:原语关系梳理(Plugin / Skill / Workflow / Agent /Hooks/Mod)
总纲:Plugin 是盒子,Skill 是说明书,Agent 是工人,Workflow 是流水线;Hooks、CLAUDE.md、MCP、Mods 是地基设施。
调研时间:2026-10-28。与前篇《CC生态-三种工作流对比》配套阅读。
一、各原语是什么
| 原语 | 本质 | 载体 | 谁触发 | 一句话定位 |
|---|---|---|---|---|
| Skill | 方法/知识包 | 单个 SKILL.md(+ 资源文件) |
模型按 description 自动匹配,或手动 /命令 |
"遇到 X 类事时,这么做" |
| Agent(Subagent) | 执行者 | .claude/agents/*.md 配置 |
主会话委派(Task 工具) | "派一个独立上下文的 Claude 去干这件事,只要结果" |
| Workflow | 任务编排结构 | 无专属文件------Agent 组合 + workflow 脚本,或官方 dynamic workflow | 编排者会话或脚本 | "把大任务拆成多步、多角色、可并行的执行图" |
| Plugin | 打包分发容器 | .claude-plugin/plugin.json + marketplace |
用户安装/启用 | "把 skills+agents+commands+hooks+MCP 打成一个可安装包" |
| Hook | 强制规则 | settings.json 中的 shell 命令 |
工具生命周期事件(PreToolUse 等) | "这一步必须发生,不看模型脸色" |
| CLAUDE.md | 常驻上下文 | 项目/用户/企业级 Markdown | 每轮自动注入 | "这个项目的背景常识,永远记得" |
| Slash Command | 手动命令 | commands/*.md |
用户输入 | 已并入 Skills 体系(v2.1.3 起) |
| Output Style | 行为风格 | output-styles/*.md |
用户切换 | "回答用什么腔调/格式" |
| Routine | 定时/事件自动化 | 配置 + 触发器 | 时间/事件 | "每周一早上自动跑这个编码任务" |
| Managed Agent | 云端托管执行者 | 官方云端 | 事件/API | "不在你终端跑的 agent" |
| Dynamic Workflow | 自动编排 | 无文件,模型自规划 | 官方引擎 | "Claude 自己拆任务、派子代理、校验结果" |
| Mod | 可编程行为改写 | 插件内 TS 函数 | 运行时拦截 | "改写 prompt、拦工具调用、替换内置行为" |
| MCP | 外部能力接口 | MCP server 配置 | 模型调用工具 | "接入外部系统(数据库、API)" |
二、包含关系(谁装谁)
| 容器 | 能装什么 | 不能装什么 |
|---|---|---|
| Plugin | skills、agents、hooks、MCP servers、output styles、mods | 不能装 workflow(workflow 是运行时结构,不是资产) |
项目 .claude/ |
skills/、agents/、settings.json(hooks)、CLAUDE.md | 不能跨项目复用 |
| Workflow | N 个 subagent + 主会话编排 + worktrees | 不"包含" skill------skill 是被 agent 消费的方法 |
依赖方向:Plugin ⊃ {Skill, Agent, Hook, MCP},被 Workflow 消费 。
Skill 和 Agent 都可独立存在(放 .claude/ 不进 plugin);Workflow 不"拥有"任何资产,它是调用方。
三、使用场景
| 场景 | 首选原语 | 为什么 |
|---|---|---|
| 团队编码规范(提交格式、评审清单) | Skill | 一次写好多处复用,不占常驻上下文 |
| 必须每次执行(保存后格式化、禁改 main) | Hook | 唯一"保证"级机制(exit code 2 阻断) |
| 项目背景(技术栈、命令别名) | CLAUDE.md | 每轮自动注入,但须保持精简 |
| 读大文件/大代码库只回结论 | Subagent | 独立上下文不污染主窗口 |
| 多模块并行改码 | Workflow(subagent + worktrees) | 隔离 + 并行,主会话只收摘要 |
| 跨仓库/跨团队分发 | Plugin | 官方目录 2026-09-25 已开放提交(自动校验+安全扫描+安装分析) |
| 每天/每周重复的编码任务 | Routine | 定时无人值守 |
| 非本地执行(CI、云端) | Managed Agent | 不依赖你的终端 |
| 超长任务不想手写编排 | Dynamic Workflow / CC Projects | 官方自动规划子代理(2026-05 研究预览 / 2026-09-17 Beta) |
| 改写默认行为(如强制 TDD 流程) | Mod | 比文本规则确定,比 hook 灵活(2026-10-01 上线) |
| 接外部系统 | MCP | MCP 2026-07-28 规范,~40 个产品兼容 |
四、优缺点对比
| 原语 | 优点 | 缺点 |
|---|---|---|
| Skill | 复用性最强、按需加载省 token、跨工具通用、单文件好维护 | 非确定性(描述差就不触发);无独立上下文;管不住"必须执行"的事 |
| Agent | 隔离 + 独立窗口;可锁模型(审查挂 Opus、分类挂 Haiku);只回摘要 | token 贵;委派粒度要设计;小任务不划算 |
| Workflow | 并行 + 计划跨会话持有;对抗式分工质量高 | 最贵;编排需显式设计;模型升级后要重验证 |
| Plugin | 一键分发整套配置;官方目录带安全扫描与安装分析 | 质量参差(Snyk:36% 第三方 skill 检出注入);需版本管理 |
| Hook | 真保证、零 token 成本 | 只能做确定性判断;写错会拦死正常流程 |
| CLAUDE.md | 零成本上手、必加载 | 膨胀即整体失效;无选择性注入 |
| Routine / Managed Agent | 无人值守、云端跑 | 可控性差,出问题不在眼前 |
| Dynamic Workflow | 免去手写编排 | 黑盒,企业审查难;研究预览阶段 |
| Mod | 可编程、确定性强于文本规则 | 要写 TS;刚上线(2026-10-01),生态未成熟 |
| MCP | 标准化、跨产品兼容 | 企业托管鉴权配置复杂;依赖外部 server 稳定性 |
五、最小可用组合(记忆锚点)
个人编码 3 件套:精简 CLAUDE.md + 高频 Skill + 关键 Hook 。
团队再加:审查 Subagent + Plugin 打包。其余原语全部按需取用,不为用而用。