
Claude Code 插件体系全解析官方插件、目录结构与实战部署指南【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code本篇指南以 Claude Code 仓库中的 plugins/README.md 为核心系统讲解 Claude Code 插件Plugin的构成要素、官方内置的 12 个插件能力矩阵、安装启用方式与标准目录结构并结合仓库中各插件的源码与文档深入展开。读完本文你将掌握 Claude Code 插件系统的运行原理能够按需选用官方插件代码评审、Git 工作流、安全防护、Hook 治理等并理解一个合规插件的完整组织形态。什么是 Claude Code 插件Claude Code 是一款运行在终端中的 Agent 编程工具能够理解代码库并通过自然语言完成日常任务、解释复杂代码与处理 Git 工作流。插件Plugin正是其扩展能力的核心载体插件通过自定义斜杠命令Slash Commands、专用 Agent、Hooks 与 MCP 服务器来增强 Claude Code 的功能并且可以在项目与团队之间共享提供一致的工具链与工作流。从 plugins/README.md 的说明看本仓库的plugins/目录收录了一批官方插件它们是 Claude Code 插件系统能力的示例更多插件可通过社区市场marketplaces获取。官方插件能力矩阵仓库共收录 12 个官方插件覆盖 Agent SDK 开发、代码评审、Git 工作流、输出风格、功能开发、前端设计、Hook 治理、PR 评审、自主迭代与安全防护等多个维度。下面逐一展开每个插件的能力与内部构成。agent-sdk-devAgent SDK 应用开发套件该插件为基于 Claude Agent SDK 构建应用提供全生命周期支持详见 plugins/agent-sdk-dev/README.md。命令/new-sdk-app交互式引导创建 Agent SDK 项目。会询问语言TypeScript/Python、项目名、Agent 类型coding/business/custom、起点minimal/basic/具体示例与工具链偏好npm/yarn/pnpm 或 pip/poetry随后检查并安装最新 SDK、生成项目文件与环境文件.env.example、.gitignore、提供可运行示例并自动执行类型检查TypeScript 的npx tsc --noEmit或语法校验Python最后自动调用对应的验证 Agent 完成设置核验。Agentagent-sdk-verifier-py与agent-sdk-verifier-ts分别对 Python 与 TypeScript 的 SDK 应用做最佳实践核验检查项包括 SDK 安装版本、环境配置requirements.txt/pyproject.toml/tsconfig.json、SDK 使用模式、Agent 初始化、环境与安全.env、API Key、错误处理与文档完整性。其输出为结构化报告整体状态PASS / PASS WITH WARNINGS / FAIL、关键问题、告警、通过项清单与带文档引用的改进建议。该插件的 Agent 定义文件位于 plugins/agent-sdk-dev/agents/agent-sdk-verifier-py.md 与 plugins/agent-sdk-dev/agents/agent-sdk-verifier-ts.md命令定义位于 plugins/agent-sdk-dev/commands/new-sdk-app.md。典型工作流/new-sdk-app code-reviewer-agent→ 回答交互问题如 TypeScript coding agent basic 起点→ 自动核验 →echo ANTHROPIC_API_KEYyour_key_here .env→npm start运行。最佳实践包括始终使用最新 SDK、部署前先运行验证 Agent、绝不提交.env或硬编码 API Key。claude-opus-4-5-migration模型迁移技能该插件提供claude-opus-4-5-migration技能用于将代码与提示词从 Sonnet 4.x 和 Opus 4.1 迁移到 Opus 4.5自动化处理模型字符串、beta headers 与提示词调整。其技能定义位于 plugins/claude-opus-4-5-migration/skills/claude-opus-4-5-migration/SKILL.md并带有 references 参考文档辅助迁移判断。code-review多 Agent 并行 PR 评审该插件通过多个专用 Agent 并行评审 Pull Request并采用置信度评分过滤误报详见 plugins/code-review/README.md。命令/code-review执行自动 PR 评审。流程为检查评审必要性跳过已关闭、草稿、琐碎或已评审的 PR→ 收集仓库中的 CLAUDE.md 规范文件 → 汇总 PR 变更 → 并行启动 4 个评审 Agent其中 2 个做 CLAUDE.md 合规审计、1 个扫描明显 bug、1 个基于 git blame/历史做上下文分析→ 对每个问题按 0–100 评分 → 过滤低于 80 分置信度的条目 → 输出评审结果默认输出到终端--comment时作为 PR 评论发布。置信度评分体系0误报、25可能真实、50真实但次要、75真实且重要、100确定真实。被过滤的误报包括 PR 之前就存在的旧问题、看似 bug 实非 bug 的代码、吹毛求疵的 nitpick、linter 能捕获的问题、泛泛的质量问题以及带 lint ignore 注释的问题。配置调整默认阈值 80 可修改编辑 plugins/code-review/commands/code-review.md 中Filter out any issues with a score less than 80的数字即可也可在该文件添加安全、性能、可访问性等专项评审 Agent。前置要求Git 仓库与 GitHub 集成、已安装并认证 GitHub CLIgh auth login建议维护清晰的 CLAUDE.md 以获得更好的合规检查效果。评论中的代码链接必须使用完整 SHA 与#L[start]-L[end]行区间格式。插件元数据见 plugins/code-review/.claude-plugin/plugin.json作者 Boris Cherny版本 1.0.0。commit-commandsGit 工作流自动化该插件将提交、推送、建 PR、清理分支整合为单条斜杠命令详见 plugins/commit-commands/README.md。/commit分析 git status同时查看已暂存与未暂存变更参考近期提交信息以匹配仓库风格生成提交信息、暂存相关文件并创建提交。遵循 conventional commit 实践自动规避含密钥的文件.env、credentials.json提交信息中附带 Claude Code 署名。/commit-push-pr一键完成建分支如在 main 上→ 暂存并提交 → 推送 origin → 用gh pr create创建 PR → 输出 PR 链接。PR 描述会分析分支全部提交而非仅最新一条生成 1–3 条变更摘要、测试计划清单与 Claude Code 署名。要求gh已安装认证且仓库有origin远端。/clean_gone清理远端已删除的本地分支列出标记为 [gone] 的分支、安全移除关联 worktree 后再删除分支并报告清理结果。三个命令的定义分别位于 plugins/commit-commands/commands/commit.md、plugins/commit-commands/commands/commit-push-pr.md 与 plugins/commit-commands/commands/clean_gone.md。explanatory-output-style 与 learning-output-style输出风格扩展这两个插件通过 SessionStart Hook 在会话启动时注入教育性上下文复刻已弃用/未发布的 Claude Code 输出风格explanatory-output-style提供实现选择与代码库模式的解读洞见Hook 处理脚本为 plugins/explanatory-output-style/hooks-handlers/session-start.sh。learning-output-style在决策点鼓励用户写出有意义的代码约 5–10 行同时接收教育性洞见属于交互式学习模式Hook 处理脚本为 plugins/learning-output-style/hooks-handlers/session-start.sh。feature-dev七阶段功能开发工作流该插件提供/feature-dev引导式功能开发命令并配套三个专用 Agent见 plugins/feature-dev/agents/ 目录code-explorer代码库分析code-architect架构设计code-reviewer质量评审。整个流程采用结构化的 7 阶段方法从探索、设计到实现与评审形成完整闭环。命令定义位于 plugins/feature-dev/commands/feature-dev.md。frontend-design前端设计技能该插件提供frontend-design技能帮助创建独特、生产级的前端界面避免千篇一律的AI 审美。技能会在前端相关工作中被自动唤起提供大胆的设计选择、排版、动效与视觉细节指引技能定义见 plugins/frontend-design/skills/frontend-design/SKILL.md。hookify无代码创建自定义 Hook该插件让用户无需手写复杂的hooks.json即可创建 Hook通过分析会话模式或显式指令生成轻量 markdown 规则文件详见 plugins/hookify/README.md。命令族/hookify 指令从显式指令生成规则/hookify无参时分析最近会话中被纠正或令你不满的行为/hookify:list列出规则/hookify:configure交互式启停规则/hookify:help获取帮助。规则文件格式位于项目.claude/目录使用 YAML frontmatter markdown 正文。关键字段包括name、enabled、eventbash/file/stop/prompt/all、patternPython 正则、actionwarn默认仅提示、block阻止执行与conditions多条件所有条件须同时满足。内置实现Hook 处理器位于 plugins/hookify/hooks/pretooluse.py、plugins/hookify/hooks/posttooluse.py、plugins/hookify/hooks/stop.py 与 plugins/hookify/hooks/userpromptsubmit.py核心逻辑封装在 plugins/hookify/core/rule_engine.py 与 plugins/hookify/core/config_loader.py规则编写指导见 plugins/hookify/skills/writing-rules/SKILL.md。插件仅依赖 Python 3.7 标准库无第三方依赖。示例规则仓库 plugins/hookify/examples/ 提供了 4 个可直接参考的规则文件例如拦截rm -rf/mkfs/format等破坏性命令action: block、警告调试代码console.log(/debugger;、在停止会话前要求先运行测试not_contains检查 transcript 中的测试命令等。plugin-dev插件开发工具包该插件是面向插件开发者的完整工具集含 7 个专家技能与 AI 辅助创建能力详见 plugins/plugin-dev/README.md。命令/plugin-dev:create-plugin8 阶段引导式建插件工作流Agentagent-creatorAgent 创建、plugin-validator插件校验、skill-reviewer技能评审技能覆盖插件开发全链路——插件结构plugins/plugin-dev/skills/plugin-structure/SKILL.md、命令开发plugins/plugin-dev/skills/command-development/SKILL.md、Agent 开发plugins/plugin-dev/skills/agent-development/SKILL.md、Hook 开发plugins/plugin-dev/skills/hook-development/SKILL.md、MCP 集成plugins/plugin-dev/skills/mcp-integration/SKILL.md、插件设置plugins/plugin-dev/skills/plugin-settings/SKILL.md与技能开发plugins/plugin-dev/skills/skill-development/SKILL.md各技能均配有 examples 与 references 目录。pr-review-toolkit专业 PR 评审工具集该插件提供可指定评审维度的 PR 评审命令与 6 个专业 Agent详见 plugins/pr-review-toolkit/README.md。命令/pr-review-toolkit:review-pr通过可选参数指定评审重点comments、tests、errors、types、code、simplify、allAgentcomment-analyzer评论分析、pr-test-analyzer测试分析、silent-failure-hunter静默失败排查、type-design-analyzer类型设计分析、code-reviewer代码评审、code-simplifier代码简化定义见 plugins/pr-review-toolkit/agents/ 目录。ralph-wiggum自主迭代循环该插件实现Claude 反复处理同一任务直到完成的交互式自引用循环详见 plugins/ralph-wiggum/README.md。命令/ralph-loop与/cancel-ralph启动/停止自主迭代循环HookStop 事件拦截退出尝试以继续迭代Hook 定义见 plugins/ralph-wiggum/hooks/hooks.json处理脚本为 plugins/ralph-wiggum/hooks/stop-hook.sh另有 plugins/ralph-wiggum/scripts/setup-ralph-loop.sh 辅助搭建循环环境。security-guidance安全提醒 Hook该插件提供安全提醒 Hook在编辑文件时警告潜在安全问题详见 plugins/security-guidance/README.md。Hook 类型PreToolUse监控 9 类安全模式包括命令注入、XSS、eval 使用、危险 HTML、pickle 反序列化与os.system调用等实现细节Hook 配置见 plugins/security-guidance/hooks/hooks.json核心处理逻辑在 plugins/security-guidance/hooks/security_reminder_hook.py并配套 plugins/security-guidance/hooks/patterns.py模式定义、plugins/security-guidance/hooks/diffstate.pydiff 状态、plugins/security-guidance/hooks/review_api.py评审 API与 plugins/security-guidance/hooks/llm.py 等模块通过 plugins/security-guidance/hooks/sg-python.sh 启动。插件的安装与启用根据 plugins/README.md这些官方插件随 Claude Code 仓库提供在自有项目中使用的方式如下全局安装 Claude Codenpm install -g anthropic-ai/claude-code进入项目并启动 Claude Codeclaude使用/plugin命令从市场安装插件或在项目的.claude/settings.json中配置插件。部分插件如 hookify还支持手动加载测试例如cc --plugin-dir /path/to/hookify需要注意的是插件命令与 Agent 的自动可用性以各插件随 Claude Code 分发的实际情况为准对于 hookify 这类依赖项目本地规则文件的插件规则文件必须放在项目根目录的.claude/目录下而非插件目录才会生效。标准插件目录结构每个插件遵循标准的 Claude Code 插件结构见 plugins/README.mdplugin-name/ ├── .claude-plugin/ │ └── plugin.json # 插件元数据 ├── commands/ # 斜杠命令可选 ├── agents/ # 专用 Agent可选 ├── skills/ # Agent Skills可选 ├── hooks/ # 事件处理器可选 ├── .mcp.json # 外部工具配置可选 └── README.md # 插件文档各目录含义.claude-plugin/plugin.json插件元数据声明插件名称、描述、版本与作者。仓库中 12 个插件均带此文件例如 plugins/agent-sdk-dev/.claude-plugin/plugin.json 声明了name: agent-sdk-dev、version: 1.0.0与作者信息commands/markdown 格式的斜杠命令定义如/code-review实现在 plugins/code-review/commands/code-review.mdagents/markdown 格式的专用 Agent 定义如 plugins/pr-review-toolkit/agents/silent-failure-hunter.mdskills/Agent Skills如 frontend-design 与 plugin-dev 的技能目录hooks/事件处理器与hooks.json注册配置如 plugins/security-guidance/hooks/hooks.json 注册 PreToolUse 事件.mcp.jsonMCP 外部工具配置本仓库插件未启用属可选能力README.md插件文档说明功能、用法、故障排查与最佳实践。以仓库实际插件验证该结构hookify 同时具备commands/5 个命令定义、agents/conversation-analyzer、skills/writing-rules、hooks/4 个 Python Hook 处理器与 hooks.json与core/、matchers/、utils/、examples/等辅助目录是结构最完整的范例之一。贡献新插件的规范若要在本目录新增插件plugins/README.md 给出了如下要求遵循标准插件结构编写完整的 README.md在.claude-plugin/plugin.json中添加插件元数据记录所有命令与 Agent提供使用示例。写在最后本仓库的plugins/目录展示了 Claude Code 插件系统的典型形态命令commands、Agentagents、技能skills与 Hookhooks四种扩展载体既可以独立工作也可以像 code-review、hookify、plugin-dev 那样组合成完整的工作流。对于开发团队可直接复用 code-review 与 commit-commands 规范日常迭代节奏用 security-guidance 与 hookify 守住安全底线对于二次开发plugin-dev 提供的 7 项技能与create-plugin的 8 阶段流程是快速上手的完整路线图。【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考