关于 review-quick
Quick Review 是一项用于检查进行中工作和近期提交的技能。它检测 Git 工作树中的变更,并并行开展八个领域的审查,最后汇总发现。
主要功能
- 01自动检测变更
- 02涵盖提交与工作树改动
- 03并行审查八个领域
- 04汇总审查发现
适用场景
- 01提交前检查变更
- 02创建 Pull Request 前审查
- 03评估已完成的功能或缺陷修复
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jimweller/ clanker-skills --skill review-quick安装后在 Claude Code 中输入/review-quick确认已加载。
详细介绍
STARTER_CHARACTER = ⚡
快速审查
并行审查进行中的工作和近期提交,覆盖 8 个重点领域。无需参数。自动检测变更。
步骤 1:检测变更
计算自上次触及项目根目录以来的变更。涵盖已提交、暂存、未暂存和未跟踪的工作。
PROJECT_ROOT=$(git rev-parse --show-toplevel)
BASELINE=$(git log -1 --format=%H -- "$PROJECT_ROOT")
[ -z "$BASELINE" ] && BASELINE=$(git rev-list --max-parents=0 HEAD)
git log --oneline ${BASELINE}..HEAD
git diff ${BASELINE} --find-renames --stat
git diff ${BASELINE} --find-renames
git status --porcelain
git ls-files --others --exclude-standard
diff 中没有 ..HEAD,因此会涵盖从基线到工作树的变更,包括暂存和未暂存的编辑。--find-renames 会将重命名显示为包含新旧路径的 R<score> 条目,因此纯重命名不会折叠成空 diff。git status --porcelain 是所有已修改、新增、删除、重命名、复制和未跟踪条目的权威列表;使用它确认重命名检测结果。ls-files --others 会显示新的未跟踪文件。匹配 .gitignore 的文件会被排除。
仅当以下四项信号均为空时才停止:git diff 为空、git status --porcelain 为空、ls-files --others 为空,以及 git log ${BASELINE}..HEAD 为空。然后报告“没有可审查的变更”并停止。
步骤 2:读取未跟踪文件
读取 git ls-files --others --exclude-standard 列出的每个文件的完整内容。未跟踪文件没有 diff 表示。
步骤 3:并行派发 8 个审查 Agent
针对每个重点领域,派发 8 个并行审查任务。如果有子 Agent 可用,则使用子 Agent;否则按顺序执行:
| Agent | 子 Agent 类型 |
|---|---|
| 架构与设计 | review-architecture |
| 正确性与 Bug | review-correctness |
| 运维就绪度 | review-ops |
| 性能 | review-performance |
| 代码质量 | review-quality |
| 安全性 | review-security |
| SOLID 原则 | review-solid |
| 测试 | review-testing |
每个审查提示词包含:
- 步骤 1 的完整 diff 输出
- 步骤 2 中任何未跟踪文件的内容
- 指令:“审查以下变更,重点关注你的审查领域。以回复形式返回审查结果。”
不要打包 repomix。每个 Agent 的提示词都包含所需的全部上下文。
步骤 4:汇总审查结果
等 8 个 Agent 全部返回后,生成一份汇总报告:
# Quick Review Report
## Summary
- Total findings: <N>
- High: <count>
- Medium: <count>
- Low: <count>
## Findings by Severity
### High
[All High findings from all 8 agents, ordered by file:line]
### Medium
[All Medium findings from all 8 agents, ordered by file:line]
### Low
[All Low findings from all 8 agents, ordered by file:line]
适用场景
此技能会在以下情况下自动加载:
- 刚完成 Bug 修复或功能实现
- 即将提交工作或创建 PR
- 子 Agent 驱动的开发任务刚通过规范合规审查
也可以通过斜杠命令调用,对当前工作进行临时审查。