Agent Skills、SubAgent、Hooks、Plugin一览表

在 Claude Code (CLI) 的生态系统中，这四个概念共同构成了一套强大的自动化协作体系。你可以把它们想象成一个高效研发团队的组成部分：

简单来说：

以下是详细的深度解析与对比：

定义：它是给 AI 看的操作指南 。通常是一个 Markdown 文件 (SKILL.md)，里面写满了具体的步骤、模板或最佳实践。
核心作用 ：标准化输出。当你想让 Claude 遵循特定的代码风格、提交规范或工作流时使用。
上下文状态 ：共享主上下文。Skill 的内容会被加载到当前的主对话中，AI 一边读手册一边干活。
触发方式 ：可以通过 /skill-name 显式调用，或者让 Claude 根据语义自动使用。
例子：写一个 "generate-pr-description" 的 Skill，里面写好"请根据 git diff 生成包含 Summary 和 Test Plan 的 PR 描述"。

定义：它是拥有独立大脑和独立记忆的 AI 实例。它有自己的 System Prompt（人设），并且在一个全新的、隔离的上下文窗口中运行。
核心作用 ：任务分流与隔离。用于处理需要大量阅读、长时间探索或极度消耗 Token 的任务。
上下文状态 ：完全隔离 。
- 主 Agent 派活给 SubAgent -> SubAgent 在小黑屋里读了 50 个文件 -> 干完活只给主 Agent 一个总结。
- 优势：防止主 Agent 的上下文被无关细节撑爆（变贵且变笨）。
自动委派：Claude Code 可以自动判断"这个任务太复杂，我派个 SubAgent 去做"。
例子："Code Reviewer"（代码审查员），它会读取整个模块的代码，分析完后只告诉你"这 3 个地方有 Bug"，中间读代码的过程不会占用你的主对话 Token。

定义：它是事件驱动的本地脚本。它不是 AI，而是死板的 Shell 命令或脚本，绑定在 Claude Code 的生命周期事件上。
核心作用 ：在 AI 动手前或动手后，强制执行 某些逻辑，或者自动注入信息。它不依赖 AI 的"思考"，是硬性的规则。
触发方式：系统事件触发（如"用户刚按下回车"、"AI 刚想调用工具"、"会话刚开始"）。
例子：
- PreToolUse：当 AI 想运行 rm -rf 时，Hook 自动拦截并拒绝，起到"安全阀"作用。
- PostToolUse：当 AI 修改完 .py 文件后，Hook 自动运行 black 格式化代码。
- UserPromptSubmit：每次你提问时，Hook 自动把当前的 git status 附加到你的问题后面。

定义：它是一个容器。它本身不产生智能，而是把上述的 Skills、SubAgents、Hooks 以及 MCP Servers（工具连接器）打包在一起。
核心作用 ：它把 Skills 、SubAgents 、MCP Servers (工具连接器) 和 Hooks (钩子) 打包在一起，方便你分享给别人或在不同项目间复用。
形式：通常是一个包含 claude-plugin.json 描述文件的目录或 Git 仓库。
例子：你做了一个 Python-Web-Dev-Plugin，同事安装后，立刻拥有了 Python 相关的 Skills、专门调试 Python 的 SubAgent 以及自动格式化的 Hooks。

我们用一个**"装修房子"**的例子来类比这四个概念：

概念	类比	核心作用	触发方式	是否消耗 Token
Skill (技能)	装修手册	教 AI 具体怎么贴瓷砖、怎么刷漆	AI 觉得需要时查阅	是
SubAgent (子智能体)	水电工/木工	把复杂的活包给专业的人，干完只汇报结果	主管 (主 Agent) 派单	否 (主对话不消耗)
Hooks (钩子)	安全闸/感应灯	进门自动开灯(注入信息)，漏水自动关阀(拦截危险)	系统事件自动触发	否 (脚本运行不耗)
Plugin (插件)	装修队工具包	一个箱子，里面装着手册、工人和感应器	用户安装	-

想象你正在用 Claude Code 修复一个复杂的 Bug，这四者是如何配合的：

Hooks (UserPromptSubmit) ：
- 你输入"修一下登录报错"，按下回车。Hook 自动检测到这周是"性能优化周"，悄悄在你的提示词后加上了"请额外注意代码性能"的系统指令。
SubAgent (BugHunter) ：
- 主 Agent 发现这个问题涉及多个模块，于是派出了名为 BugHunter 的 SubAgent。
- BugHunter 在隔离环境中读取了 50 个日志文件和 20 个源码文件（主 Agent 对此一无所知，保持清爽）。
- BugHunter 汇报："定位到 auth.py 第 30 行有逻辑死锁"。
Agent Skill (Secure-Coding) ：
- 主 Agent 准备修复。它调用了 Secure-Coding Skill，里面规定了"修改认证模块必须使用特定的加密库"。
- 主 Agent 按照 Skill 的要求生成了修复代码。
Hooks (PostToolUse) ：
- 代码写入文件后，Hook 立即触发，运行了单元测试。如果测试失败，它会直接报错给 AI，让 AI 重试。
Plugin ：
- 以上所有的配置（BugHunter 的人设、Secure-Coding 的规范、Hooks 的脚本）都来自你安装的 Company-Standard-Dev 插件。

2025年12月18日 ：Anthropic 将 Agent Skills 捐赠为开放标准，由 Agentic AI Foundation（AAIF）维护。
生态扩展：微软（VS Code）、OpenAI（ChatGPT）、Google（Gemini Function Packages）均已采用类似理念。
企业价值：某物流公司部署后，配送延误率 ↓42%，人力成本 ↓28% 。