SuperAPI AI 工具集

review

通用与其它

查看项目

更新于 10-16 08:10

技能介绍

用途:按需审查代码质量。可审查手写代码、评估现有代码库,或在合并前检查某个分支。产出为一份合并报告,发现项带稳定性编号,用户可按 id 操作。

主要能力:默认并行运行四个审查智能体,报告名分别为 vgv-review、architecture-review、test-quality-review、code-simplicity-review,分别检查 VGV 标准、架构、测试质量与代码简洁性。合并流程会去重、确定性排序,分配稳定的 FINDING-NN id,并写入 <PWD>/docs/code-review/<slug>/review.md。每个发现项还带稳定规则 id(如 vgv/missing-null-check),可按类别处理。

使用方式:技能接受审查范围参数(文件路径或目录)。提供路径时会校验存在性,并由第一个路径推导 scope slug(去扩展名后将 / 换成 -);未提供路径时运行 ${CLAUDE_SKILL_DIR}/scripts/detect-review-scope.sh 检测分支或默认范围。若在默认分支无 diff,会通过提问让用户选择指定文件、目录或整个项目,不会未经确认默认全项目。运行前执行 pwd 取绝对路径,子智能体各自报告写入 <PWD>/docs/code-review/<slug>/raw/。项目可在 CLAUDE.md 中追加或替换默认智能体集。

审查后可选操作:修复 Critical、修复 Critical+Important、修复指定 id、以 PR 评论形式提交发现项、保留报告退出。修复仅限原审查范围内的文件,每次修复尝试一次,随后运行项目 linter 与测试;不重跑智能体。

限制:该技能为建议性,未获用户选择前不执行任何操作。智能体失败非致命,但会在报告头与摘要中记录并提示审查不完整。报告为未跟踪的工作文件,需自行提交或删除。同一范围重跑只覆盖该 slug 目录,不同分支或路径使用不同 slug。修复若需改动范围外文件,会标记而非静默扩大范围。资料未提供价格、平台等信息。