claude-howto PR Review 插件实战构建安全、测试与性能全覆盖的自动化代码评审工作流【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本篇文章以 claude-howto 仓库中 vi/07-plugins/pr-review/README.md 为核心完整拆解 PR Review 插件的安装、组成、配置与运行原理。读者将掌握如何用一条/plugin install pr-review命令把安全分析、测试覆盖检查、文档校验、代码质量评估与性能影响分析打包成可复用的代码评审流水线并理解其背后的 slash command、subagent、MCP server 与 hook 是如何协同工作的。插件定位一条命令集成的完整 PR 评审工作流在 Claude Code 的扩展体系中插件Plugin是最高层的打包机制——它把 slash commands、subagents、MCP servers、hooks 等多项定制能力捆绑成一个可安装的单元。PR Review 插件正是这种模式的一个典型实现它围绕评审一个 Pull Request这个单一目标组合了安全、测试、文档、代码质量和性能五个维度的检查覆盖从拉取 PR 数据到输出最终评审报告的完整链路。从仓库中的插件总览文档 07-plugins/README.md 可以看到插件由插件清单manifest、commands、agents、skills、hooks、MCP 配置等目录组成安装时一次配置全部组件。PR Review 插件正是按照这一标准结构组织的。安装与前置条件环境要求根据插件的 README运行 PR Review 插件需要满足以下条件条件说明Claude Code 2.1插件机制所依赖的最低版本GitHub 访问权限通过 GitHub MCP server 拉取 PR 数据Git 仓库插件的前置校验 hook 会验证当前目录是 Git 仓库安装命令/plugin install pr-review安装过程中Claude Code 会解析插件定义并依次配置三个 slash command、三个 subagent、GitHub MCP server 与 pre-review hook。安装完成后这些组件即可在当前会话中使用。此外根据 07-plugins/README.md 的说明从 v2.1.157 起插件无需 marketplace 也可自动加载放置在.claude/skills目录下即可对于本地开发调试还可以使用claude --plugin-dir ./path/to/plugin启动并验证插件。安装后若需让改动即时生效可执行/reload-plugins。配置 GitHub Token插件通过 GitHub MCP server 获取 PR 数据需要先设置访问令牌export GITHUB_TOKENyour_github_token该环境变量会被注入到 MCP server 配置的env字段中详见下文GitHub MCP 集成一节。插件组成四大组件全景拆解PR Review 插件在仓库中的目录结构如下07-plugins/pr-review/ ├── README.md # 插件说明与使用文档 ├── commands/ # 三个 slash command 定义 │ ├── check-security.md │ ├── check-tests.md │ └── review-pr.md ├── agents/ # 三个评审子代理 │ ├── performance-analyzer.md │ ├── security-reviewer.md │ └── test-checker.md ├── hooks/ │ └── pre-review.js # 评审前置校验 hook └── mcp/ └── github-config.json # GitHub MCP server 配置三个 Slash Command命令功能/review-pr综合 PR 评审安全、测试、文档、代码质量、性能五合一/check-security专注安全审查/check-tests测试覆盖与质量分析从 commands/review-pr.md 的 frontmatter 可以看到每个命令都通过 YAML 头声明name与description让 Claude Code 在会话中识别并触发对应技能。该命令文档标注的适用版本为 Claude Code 2.1.220更新日期为 2026 年 8 月 4 日。三个评审子代理子代理职责可用工具security-reviewer安全漏洞检测Read、Grep、Bashtest-checker测试覆盖分析Read、Bash、Grepperformance-analyzer性能影响评估Read、Grep、Bash三个子代理的 frontmatter 中都显式声明了tools: Read, Grep, Bash即它们通过读取源码、搜索代码模式和执行命令来开展分析不需要额外网络权限。一个前置 Hook 与一个 MCP ServerHookpre-review.js在评审开始前校验 Git 仓库状态详见下文源码解析。MCP ServerGitHub 集成用于获取 PR 相关数据。三个核心命令详解/review-pr综合 PR 评审这是插件的总入口一次触发完成五类检查安全分析Security analysis测试覆盖验证Test coverage verification文档更新检查Documentation updates代码质量检查Code quality checks性能影响评估Performance impact assessment/check-security专注安全审查当只需要针对安全问题做快速响应时使用该命令聚焦以下维度认证/授权检查Authentication/authorization checks数据暴露风险Data exposure risks注入漏洞Injection vulnerabilities加密弱点Cryptographic weaknesses日志中的敏感数据Sensitive data in logs/check-tests测试覆盖检查用于评估测试是否跟上了代码变更检查测试覆盖率百分比识别未被测试覆盖的代码路径评估测试质量建议补充缺失的测试用例验证边界条件是否覆盖三个子代理的职责边界security-reviewer安全评审专家专门发现安全漏洞重点关注四类问题认证/授权问题Authentication/authorization issues数据暴露Data exposure注入攻击Injection attacks安全配置Secure configurationtest-checker测试覆盖分析专家负责从四个方面评估测试资产覆盖率百分比Coverage percentage缺失的测试用例Missing test cases测试质量评估Test quality assessment边界条件识别Edge case identificationperformance-analyzer性能影响评估专家评估代码变更对运行时的潜在影响算法复杂度Algorithm complexity数据库查询效率Database query efficiency内存占用Memory usage缓存机会Caching opportunitiesGitHub MCP 集成数据从哪来插件通过 MCP 接入 GitHub配置文件位于 mcp/github-config.json{ mcpServers: { github: { command: npx, args: [modelcontextprotocol/server-github], env: { GITHUB_TOKEN: ${GITHUB_TOKEN} } } } }关键点解读启动方式通过npx运行modelcontextprotocol/server-github这是 MCP 生态的标准 GitHub 服务端实现令牌注入env.GITHUB_TOKEN引用${GITHUB_TOKEN}环境变量占位符因此在使用前必须先执行export GITHUB_TOKEN...完成配置职责该 server 负责向 Claude Code 提供 PR 数据读写能力让评审命令能够获取真实的 PR diff、评论与文件变更信息。前置校验 Hookpre-review.js源码解析在执行评审之前插件会先运行 hooks/pre-review.js 做前置校验。从源码可以看出它依次完成两件事1. 校验当前目录是否为 Git 仓库对应源码第 12–18 行const { execSync } require(child_process); try { execSync(git rev-parse --git-dir, { stdio: pipe }); } catch (error) { console.error(❌ Not a git repository); process.exit(1); }通过git rev-parse --git-dir探测 Git 元数据目录一旦命令失败即以退出码 1 终止防止在非 Git 目录中盲目拉取 PR。2. 检查是否存在未提交的改动对应源码第 21–29 行const status execSync(git status --porcelain, { encoding: utf-8 }); if (status.trim()) { console.warn(⚠️ Warning: Uncommitted changes detected); }git status --porcelain的输出非空时给出警告注意此处是console.warn而非退出失败提醒评审结果可能与当前工作区状态不一致。最后在全部通过时输出✅ Pre-review checks passed。整个 hook 用 Node.js 标准child_process实现无第三方依赖符合插件 hook 轻量化的设计取向。端到端工作流从触发到评审报告把上述组件串起来一次/review-pr的完整执行流程如下来自 vi/07-plugins/pr-review/README.md 的 Example WorkflowUser: /review-pr Claude: 1. Runs pre-review hook (validates git repo) 2. Fetches PR data via GitHub MCP 3. Delegates security review to security-reviewer subagent 4. Delegates testing to test-checker subagent 5. Delegates performance to performance-analyzer subagent 6. Synthesizes all findings 7. Provides comprehensive review report Result: ✅ Security: No critical issues found ⚠️ Testing: Coverage is 65%, recommend 80% ✅ Performance: No significant impact Recommendations: Add tests for edge cases七个步骤分别对应插件的不同组成部分步骤组件作用1pre-review.jshook校验 Git 仓库状态2GitHub MCP server获取 PR 数据3security-reviewer子代理安全维度评审4test-checker子代理测试覆盖分析5performance-analyzer子代理性能影响评估6–7Claude 主线程汇总并输出评审报告需要注意的是上述Coverage is 65%, recommend 80%是文档给出的示意性输出用于演示报告格式实际数值会随目标仓库的测试现状而不同。深入原理插件如何完成一次评审编排从 07-plugins/README.md 描述的插件加载流程可以理解这套工作流背后的编排机制安装阶段/plugin install pr-review触发 Claude Code 下载插件清单随后按顺序配置 slash commands、subagents、MCP servers 与 hooks全部就绪后插件即被激活触发阶段用户在会话中调用/review-pr对应的 commands/review-pr.md 技能被加载其description字段向模型描述任务范围执行阶段Claude 主线程按照技能指引先让 hook 完成前置校验再通过 MCP 获取数据然后将不同评审维度委派给对应的子代理每个子代理的tools声明决定了它能使用的工具最后汇总各子代理结论生成统一报告。这种主线程编排 子代理分工 MCP 取数 hook 把关的结构正是 PR Review 插件能够在单一命令内完成多维度评审的根本原因。使用建议评审前先配置令牌务必先export GITHUB_TOKEN再执行评审命令否则 GitHub MCP server 无法连接按需选择命令粒度完整合入前用/review-pr做全面把关紧急修复或安全专项时用/check-security快速聚焦测试薄弱的分支可用/check-tests单独评估关注前置校验的警告若 hook 提示存在未提交改动建议先提交或暂存再评审保证评审结论与评审时的代码状态一致注意版本前提插件要求 Claude Code 2.1命令与子代理文档标注的验证版本为 2.1.220使用时请确保本地版本不低于该门槛。小结PR Review 插件是 claude-howto 仓库中用插件把多项 Claude Code 能力打包成一体化工作流的代表作三个 slash command 控制入口粒度三个子代理提供专业分工GitHub MCP server 解决数据来源pre-review hook 守住前置条件。理解它的目录结构与执行编排你既可以直接在团队中使用也可以参考它的组织方式为团队定制属于自己的评审或 CI 辅助插件。延伸阅读07-plugins/pr-review/README.md插件官方说明文档07-plugins/pr-review/commands/review-pr.md综合评审命令定义07-plugins/pr-review/commands/check-security.md安全审查命令定义07-plugins/pr-review/commands/check-tests.md测试检查命令定义07-plugins/pr-review/agents/security-reviewer.md安全评审子代理07-plugins/pr-review/agents/test-checker.md测试检查子代理07-plugins/pr-review/agents/performance-analyzer.md性能分析子代理07-plugins/pr-review/hooks/pre-review.js前置校验 hook 源码07-plugins/pr-review/mcp/github-config.jsonGitHub MCP 配置07-plugins/README.md插件机制总览与加载原理【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 claude-howto PR Review 插件实战：构建安全、测试与性能全覆盖的自动化代码评审工作流
claude-howto PR Review 插件实战构建安全、测试与性能全覆盖的自动化代码评审工作流【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto本篇文章以 claude-howto 仓库中 vi/07-plugins/pr-review/README.md 为核心完整拆解 PR Review 插件的安装、组成、配置与运行原理。读者将掌握如何用一条/plugin install pr-review命令把安全分析、测试覆盖检查、文档校验、代码质量评估与性能影响分析打包成可复用的代码评审流水线并理解其背后的 slash command、subagent、MCP server 与 hook 是如何协同工作的。插件定位一条命令集成的完整 PR 评审工作流在 Claude Code 的扩展体系中插件Plugin是最高层的打包机制——它把 slash commands、subagents、MCP servers、hooks 等多项定制能力捆绑成一个可安装的单元。PR Review 插件正是这种模式的一个典型实现它围绕评审一个 Pull Request这个单一目标组合了安全、测试、文档、代码质量和性能五个维度的检查覆盖从拉取 PR 数据到输出最终评审报告的完整链路。从仓库中的插件总览文档 07-plugins/README.md 可以看到插件由插件清单manifest、commands、agents、skills、hooks、MCP 配置等目录组成安装时一次配置全部组件。PR Review 插件正是按照这一标准结构组织的。安装与前置条件环境要求根据插件的 README运行 PR Review 插件需要满足以下条件条件说明Claude Code 2.1插件机制所依赖的最低版本GitHub 访问权限通过 GitHub MCP server 拉取 PR 数据Git 仓库插件的前置校验 hook 会验证当前目录是 Git 仓库安装命令/plugin install pr-review安装过程中Claude Code 会解析插件定义并依次配置三个 slash command、三个 subagent、GitHub MCP server 与 pre-review hook。安装完成后这些组件即可在当前会话中使用。此外根据 07-plugins/README.md 的说明从 v2.1.157 起插件无需 marketplace 也可自动加载放置在.claude/skills目录下即可对于本地开发调试还可以使用claude --plugin-dir ./path/to/plugin启动并验证插件。安装后若需让改动即时生效可执行/reload-plugins。配置 GitHub Token插件通过 GitHub MCP server 获取 PR 数据需要先设置访问令牌export GITHUB_TOKENyour_github_token该环境变量会被注入到 MCP server 配置的env字段中详见下文GitHub MCP 集成一节。插件组成四大组件全景拆解PR Review 插件在仓库中的目录结构如下07-plugins/pr-review/ ├── README.md # 插件说明与使用文档 ├── commands/ # 三个 slash command 定义 │ ├── check-security.md │ ├── check-tests.md │ └── review-pr.md ├── agents/ # 三个评审子代理 │ ├── performance-analyzer.md │ ├── security-reviewer.md │ └── test-checker.md ├── hooks/ │ └── pre-review.js # 评审前置校验 hook └── mcp/ └── github-config.json # GitHub MCP server 配置三个 Slash Command命令功能/review-pr综合 PR 评审安全、测试、文档、代码质量、性能五合一/check-security专注安全审查/check-tests测试覆盖与质量分析从 commands/review-pr.md 的 frontmatter 可以看到每个命令都通过 YAML 头声明name与description让 Claude Code 在会话中识别并触发对应技能。该命令文档标注的适用版本为 Claude Code 2.1.220更新日期为 2026 年 8 月 4 日。三个评审子代理子代理职责可用工具security-reviewer安全漏洞检测Read、Grep、Bashtest-checker测试覆盖分析Read、Bash、Grepperformance-analyzer性能影响评估Read、Grep、Bash三个子代理的 frontmatter 中都显式声明了tools: Read, Grep, Bash即它们通过读取源码、搜索代码模式和执行命令来开展分析不需要额外网络权限。一个前置 Hook 与一个 MCP ServerHookpre-review.js在评审开始前校验 Git 仓库状态详见下文源码解析。MCP ServerGitHub 集成用于获取 PR 相关数据。三个核心命令详解/review-pr综合 PR 评审这是插件的总入口一次触发完成五类检查安全分析Security analysis测试覆盖验证Test coverage verification文档更新检查Documentation updates代码质量检查Code quality checks性能影响评估Performance impact assessment/check-security专注安全审查当只需要针对安全问题做快速响应时使用该命令聚焦以下维度认证/授权检查Authentication/authorization checks数据暴露风险Data exposure risks注入漏洞Injection vulnerabilities加密弱点Cryptographic weaknesses日志中的敏感数据Sensitive data in logs/check-tests测试覆盖检查用于评估测试是否跟上了代码变更检查测试覆盖率百分比识别未被测试覆盖的代码路径评估测试质量建议补充缺失的测试用例验证边界条件是否覆盖三个子代理的职责边界security-reviewer安全评审专家专门发现安全漏洞重点关注四类问题认证/授权问题Authentication/authorization issues数据暴露Data exposure注入攻击Injection attacks安全配置Secure configurationtest-checker测试覆盖分析专家负责从四个方面评估测试资产覆盖率百分比Coverage percentage缺失的测试用例Missing test cases测试质量评估Test quality assessment边界条件识别Edge case identificationperformance-analyzer性能影响评估专家评估代码变更对运行时的潜在影响算法复杂度Algorithm complexity数据库查询效率Database query efficiency内存占用Memory usage缓存机会Caching opportunitiesGitHub MCP 集成数据从哪来插件通过 MCP 接入 GitHub配置文件位于 mcp/github-config.json{ mcpServers: { github: { command: npx, args: [modelcontextprotocol/server-github], env: { GITHUB_TOKEN: ${GITHUB_TOKEN} } } } }关键点解读启动方式通过npx运行modelcontextprotocol/server-github这是 MCP 生态的标准 GitHub 服务端实现令牌注入env.GITHUB_TOKEN引用${GITHUB_TOKEN}环境变量占位符因此在使用前必须先执行export GITHUB_TOKEN...完成配置职责该 server 负责向 Claude Code 提供 PR 数据读写能力让评审命令能够获取真实的 PR diff、评论与文件变更信息。前置校验 Hookpre-review.js源码解析在执行评审之前插件会先运行 hooks/pre-review.js 做前置校验。从源码可以看出它依次完成两件事1. 校验当前目录是否为 Git 仓库对应源码第 12–18 行const { execSync } require(child_process); try { execSync(git rev-parse --git-dir, { stdio: pipe }); } catch (error) { console.error(❌ Not a git repository); process.exit(1); }通过git rev-parse --git-dir探测 Git 元数据目录一旦命令失败即以退出码 1 终止防止在非 Git 目录中盲目拉取 PR。2. 检查是否存在未提交的改动对应源码第 21–29 行const status execSync(git status --porcelain, { encoding: utf-8 }); if (status.trim()) { console.warn(⚠️ Warning: Uncommitted changes detected); }git status --porcelain的输出非空时给出警告注意此处是console.warn而非退出失败提醒评审结果可能与当前工作区状态不一致。最后在全部通过时输出✅ Pre-review checks passed。整个 hook 用 Node.js 标准child_process实现无第三方依赖符合插件 hook 轻量化的设计取向。端到端工作流从触发到评审报告把上述组件串起来一次/review-pr的完整执行流程如下来自 vi/07-plugins/pr-review/README.md 的 Example WorkflowUser: /review-pr Claude: 1. Runs pre-review hook (validates git repo) 2. Fetches PR data via GitHub MCP 3. Delegates security review to security-reviewer subagent 4. Delegates testing to test-checker subagent 5. Delegates performance to performance-analyzer subagent 6. Synthesizes all findings 7. Provides comprehensive review report Result: ✅ Security: No critical issues found ⚠️ Testing: Coverage is 65%, recommend 80% ✅ Performance: No significant impact Recommendations: Add tests for edge cases七个步骤分别对应插件的不同组成部分步骤组件作用1pre-review.jshook校验 Git 仓库状态2GitHub MCP server获取 PR 数据3security-reviewer子代理安全维度评审4test-checker子代理测试覆盖分析5performance-analyzer子代理性能影响评估6–7Claude 主线程汇总并输出评审报告需要注意的是上述Coverage is 65%, recommend 80%是文档给出的示意性输出用于演示报告格式实际数值会随目标仓库的测试现状而不同。深入原理插件如何完成一次评审编排从 07-plugins/README.md 描述的插件加载流程可以理解这套工作流背后的编排机制安装阶段/plugin install pr-review触发 Claude Code 下载插件清单随后按顺序配置 slash commands、subagents、MCP servers 与 hooks全部就绪后插件即被激活触发阶段用户在会话中调用/review-pr对应的 commands/review-pr.md 技能被加载其description字段向模型描述任务范围执行阶段Claude 主线程按照技能指引先让 hook 完成前置校验再通过 MCP 获取数据然后将不同评审维度委派给对应的子代理每个子代理的tools声明决定了它能使用的工具最后汇总各子代理结论生成统一报告。这种主线程编排 子代理分工 MCP 取数 hook 把关的结构正是 PR Review 插件能够在单一命令内完成多维度评审的根本原因。使用建议评审前先配置令牌务必先export GITHUB_TOKEN再执行评审命令否则 GitHub MCP server 无法连接按需选择命令粒度完整合入前用/review-pr做全面把关紧急修复或安全专项时用/check-security快速聚焦测试薄弱的分支可用/check-tests单独评估关注前置校验的警告若 hook 提示存在未提交改动建议先提交或暂存再评审保证评审结论与评审时的代码状态一致注意版本前提插件要求 Claude Code 2.1命令与子代理文档标注的验证版本为 2.1.220使用时请确保本地版本不低于该门槛。小结PR Review 插件是 claude-howto 仓库中用插件把多项 Claude Code 能力打包成一体化工作流的代表作三个 slash command 控制入口粒度三个子代理提供专业分工GitHub MCP server 解决数据来源pre-review hook 守住前置条件。理解它的目录结构与执行编排你既可以直接在团队中使用也可以参考它的组织方式为团队定制属于自己的评审或 CI 辅助插件。延伸阅读07-plugins/pr-review/README.md插件官方说明文档07-plugins/pr-review/commands/review-pr.md综合评审命令定义07-plugins/pr-review/commands/check-security.md安全审查命令定义07-plugins/pr-review/commands/check-tests.md测试检查命令定义07-plugins/pr-review/agents/security-reviewer.md安全评审子代理07-plugins/pr-review/agents/test-checker.md测试检查子代理07-plugins/pr-review/agents/performance-analyzer.md性能分析子代理07-plugins/pr-review/hooks/pre-review.js前置校验 hook 源码07-plugins/pr-review/mcp/github-config.jsonGitHub MCP 配置07-plugins/README.md插件机制总览与加载原理【免费下载链接】claude-howtoA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-howto创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考