mcpField
C
code-reviewer

code-reviewer

github.com/nextstage-brasil测试与质量050 次安装5 天前更新
代码仓库

关于 code-reviewer

code-reviewer 是用于依据项目规则和验收标准审查代码变更的技能。它指导规则发现、差异分析和结构化反馈,并要求审查过程保持只读。

主要功能

  1. 01加载项目及分层规则
  2. 02结合上下文审查代码差异
  3. 03按严重程度排列问题
  4. 04规定议题审查结论与发布流程
  5. 05只读审查并采用指定报告结构

适用场景

  1. 01检查变更是否符合项目约定
  2. 02合并前审查已修改文件
  3. 03核对 GitLab 议题的验收标准

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nextstage-brasil/skills --skill code-reviewer

安装后在 Claude Code 中输入/code-reviewer确认已加载。

附带文件evals/evals.jsonreferences/review-report.template.md

详细介绍

代码审查员

依据项目规则和验收标准,对代码变更进行深入、建设性的审查。

Harness 发现

参见 ../nextstage-harness/references/harness-discovery.md。从 {harness_root}/rules/*.md 加载规则。首先阅读 architecture-rules.md。旧版规则:仅当 {harness_root} 不存在时,才使用 .cursor/rules/*.mdc。根据变更文件加载特定层级的规则(backend、frontend、tests、e2e)。

除非项目规则或技术栈上下文中已检测到,否则不要假定使用 Grogoo/Laravel/React。

工作流

  1. 加载适用的项目规则。
  2. 运行 git diff(必要时运行 git status)。
  3. 聚焦于已修改的文件及其上下文。
  4. 立即开始——不要询问是否可以开始。
版本收尾

在版本收尾时调用,应使用 references/review-report.template.md 将输出保存至 {product_root}/docs/versions/{version_san}/code-review-report.md。

Issue 审查模式

调用方传入 ISSUE_URL(或 project_id + issue_iid)时:

  1. 将 Issue 上下文委派给 execution-gitlab-issue 上下文流程或 gitlab-issue-context-agent;如果已提供综合信息块,不要自行调用 read_issue。
  2. 根据综合信息中的 origin/<target>...origin/<source> 进行差异比较——绝不要审查错误的分支。
  3. 需求证明门槛: 每项 AC 都必须有行为证据;只有生产者代码、没有消费者代码属于 Critical。
  4. 结论(只能选一个): Approved | Rejected | Blocked
  5. 通过 mcp-gitlab-usage 发布 GitLab 内部评论——首行格式为:Code Review | YYYY-MM-DD HH:MM (UTC) | Verdict: {Approved|Rejected|Blocked}
  6. 回复父级的最后一行:Code Review: {Approved|Rejected|Blocked}

审查优先级

在每个部分内,按严重程度排序:

  1. Critical(合并前必须修复)
  2. Warning(应修复)
  3. Suggestion(可考虑)
SOLID 与整洁代码
  • SRP、OCP、LSP、ISP、DIP
  • 命名、圈复杂度、错误处理、死代码
性能、安全性和可测试性
  • N+1、不必要的重新渲染、缺少验证
  • SQL 注入、XSS、敏感日志
  • 阻碍测试的耦合

必需的输出格式

每次审查都按以下结构编写:

执行摘要
  • 评分 1–10
  • 两行总体评估
严重问题

仅在没有此类问题时省略。包括逻辑错误、安全问题、严重的 SOLID 或架构违规。

架构与整洁代码改进

重构建议、组件边界、模式。

重构后的代码

仅当用户要求提供具体修复时才包含。

约束

  • 只读。 不要编辑、创建或删除文件——输出应为审查报告,而不是修复
  • 直接且有建设性;不要进行人身批评
  • 不要重写无关代码
  • 根据实际差异和已阅读的规则提出发现
  • 遵循代码库中体现的项目约定

参考资料

文件适用场景
references/review-report.template.md版本收尾报告
../nextstage-harness/references/artifact-layout.md报告路径
mcp-gitlab-usage发布内部审查评论

评论

支持 Markdown