mcpField
L
light-code-review

light-code-review

github.com/light-cheng测试与质量510 次安装3 天前更新
代码仓库

关于 light-code-review

light-code-review 是面向有界 Git 差异的只读审查工具,供代码审查工作流使用。它分别检查仓库规范和规格要求,并提供带引用的审查结果;不会修改文件,也不作最终通过或失败判定。

主要功能

  1. 01审查有界 Git 差异
  2. 02分别检查规范与规格
  3. 03提供带引用且唯一编号的结果
  4. 04并行运行专职审查 Agent
  5. 05只读运行

适用场景

  1. 01检查改动是否符合仓库规范
  2. 02依据 Issue 或 Spec 检查差异
  3. 03为修复与复审流程提供结果

安装

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

$npx skills add https://github.com/light-cheng/skills --skill light-code-review

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

ATTRIBUTION.md
agents/
openai.yaml
references/
EXAMPLES.md
SMELL-BASELINE.md
WORKFLOW.md

详细介绍

代码审查

light-code-review 是针对限定 Git 差异的只读专业审查器。它会在 Standards 和 Spec 维度报告并返回审查发现;它不会编辑文件、运行修复循环,也不会给出最终的 PASS / FAIL / BLOCKED。

核心行为

  1. 固定基准点。 使用 git rev-parse 解析引用;捕获 git diff <fixed-point>...HEAD 和 git log <fixed-point>..HEAD --oneline。 引用无效或差异为空时,应在运行任何子 Agent 前停止。
  2. 定位来源。 查找源问题/Spec 和仓库规范文档。缺少 Spec 时应注明“无可用 Spec”,不得凭空编造要求。
  3. 通过并行子 Agent 检查两个维度。 专用的 Standards 和 Spec 子 Agent 不共享上下文,且不得重新调用 light-code-review 或启动更多 Agent。
  4. 分别汇总。 提供 ## Standards 和 ## Spec 报告,其中包含全局唯一、规范化的审查发现 ID;若无问题,则写作 Findings: [],并为每个维度提供一行摘要。复查时保留之前的 ID。不得跨维度合并或重新排序。

每项审查发现都必须附带引用:规范文件 + 规则或代码异味名称 + 引用的代码片段,或 Spec 行号。跳过由工具强制执行的风格规则;仓库规范优先于基准代码异味集合;代码异味仍应标注为主观判断。

组成

review-loop → light-code-review → findings → Producer repair → re-review → handoff
project-review → review-loop → light-code-review → findings → Core validation → bounded repair → PASS/FAIL/BLOCKED

详细提示词和代码异味基准见 WORKFLOW.md 和 SMELL-BASELINE.md;示例见 EXAMPLES.md。

评论

支持 Markdown