Claude Code 插件体系：命令、Agent、Skill、Hook 与 MCP 的分工

plugins/是本项目最能体现 Claude Code 工程化能力的目录。它说明插件并不是单一脚本而是可以把命令、Agent、Skill、Hook 和 MCP 服务组合成一个完整工作流的扩展单元。项目中的插件覆盖了不同场景feature-dev关注结构化功能开发code-review和pr-review-toolkit关注代码审查hookify关注规则生成与执行security-guidance关注安全提醒和差异审查plugin-dev则反过来帮助开发新的 Claude Code 插件。标准插件结构本仓库给出的插件结构非常稳定典型目录如下plugin-name/ ├── .claude-plugin/ │ └── plugin.json ├── commands/ ├── agents/ ├── skills/ ├── hooks/ ├── .mcp.json └── README.mdplugin.json是插件元数据入口。commands/放 Slash Command适合定义可被用户主动触发的流程。agents/放专用 Agent适合把某类分析任务交给具备独立上下文的执行者。skills/放可被触发的能力说明与资源适合封装特定领域的方法论。hooks/放事件处理逻辑适合在工具调用、会话开始、会话结束等生命周期中插入规则。.mcp.json则用于把外部服务或工具暴露给 Claude Code。这个结构的优点是边界清楚。命令负责入口Agent 负责专项判断Skill 负责知识和执行规范Hook 负责治理MCP 负责连接外部能力。Slash Command把流程固定成入口Slash Command 适合承载明确的用户意图。比如feature-dev提供/feature-dev它把功能开发拆成 7 个阶段需求发现、代码探索、澄清问题、架构设计、实现、质量审查和总结。code-review提供/code-review它不是简单地调用一次模型而是先判断 PR 是否需要审查再收集 CLAUDE.md 规则、总结变更、启动多个并行 Agent最后用置信度过滤结果。命令的价值在于降低流程启动成本。用户不需要每次都重新描述“请先探索代码再给方案再实现再审查”插件已经把这条路径固化下来。Agent把复杂判断拆给专门角色Agent 的价值在于并行和专业化。code-review会启动多个独立 Agent从规则符合性、明显 Bug、历史上下文等角度审查 PR。pr-review-toolkit则提供评论准确性、测试覆盖、静默失败、类型设计、通用代码审查和代码简化等多个专项 Agent。这种设计适合减少单一视角带来的漏判。一个 Agent 关注测试质量另一个 Agent 关注错误处理第三个 Agent 关注类型不变量它们的输出再由主流程汇总质量通常比一次泛化审查更稳定。Skill把领域知识做成可触发能力Skill 更像是“可加载的工作说明书”。plugin-dev里包含 Hook Development、MCP Integration、Plugin Structure、Plugin Settings、Command Development、Agent Development、Skill Development 等 7 个 Skill。这些 Skill 不是把所有知识一次性塞进上下文而是采用渐进式披露先通过触发描述判断是否需要再按需读取核心说明、示例、脚本或参考材料。这对于大型插件尤其重要因为它能在保持质量的同时控制上下文体积。Hook把规则放进工具生命周期Hook 适合做治理和提醒。security-guidance使用 Hook 在文件编辑、会话结束、提交等阶段进行安全检查hookify则让用户通过轻量 Markdown 规则生成自定义 Hook不需要手写复杂的hooks.json。Hook 的关键不在于“自动化”而在于它能把规则放到正确时机执行。危险命令应该在 Bash 执行前阻断安全审查应该在变更完成后触发学习模式可以在会话开始时注入上下文。MCP把外部能力接入插件MCP 适合连接数据库、API、内部平台或其他工具。plugin-dev的 MCP Integration Skill 专门说明了 stdio、SSE、HTTP、WebSocket 等服务类型以及认证、环境变量、工具命名和性能优化等问题。当插件需要访问外部系统时把能力封装成 MCP 比在命令里硬编码调用逻辑更清晰也更容易做权限控制和复用。组合才是插件体系的重点单独看命令、Agent、Skill、Hook 和 MCP 都不复杂。真正的价值来自组合一个命令可以启动多个 AgentAgent 可以遵守 Skill 中的规范Hook 可以约束命令或工具行为MCP 可以提供外部数据README 则把这些能力解释给团队成员。本项目的插件目录给出的不是某个单点技巧而是一个可复制的扩展模型。团队如果要构建自己的 Claude Code 工作流可以先从一个命令开始再根据复杂度逐步引入 Agent、Skill、Hook 和 MCP而不是一开始就设计一个庞大的插件系统。