SuperAPI AI 工具集

kata-review-pull-requests

智能体与模型

查看项目

更新于 10-15 21:49

技能介绍

用途:对 Pull Request 或本地改动执行全面代码审查。技能会启动多个通用子代理,每个子代理获得独立上下文窗口,内联对应的审查指令、diff 与项目上下文,并行完成不同方面的检查。

主要能力:可选审查方面包括 code(项目规范通用审查)、tests(测试覆盖质量与完整性)、comments(注释准确性与可维护性)、errors(静默失败与错误处理)、types(类型设计与不变量)、simplify(代码清晰度与可维护性),默认运行全部适用项。技能会检查 git 状态、解析参数、识别变更文件,并判断哪些审查适用。

使用方式:通过 git diff --name-only 查看改动,用 gh pr view 检查是否已有 PR;读取各 references 目录下的指令文件,并读取 git diff 与 CLAUDE.md 作为项目上下文。模型档位由 node scripts/kata-lib.cjs read-config "model_profile" "balanced" 解析,默认 balanced,并按 quality/balanced/budget 映射到 opus、sonnet、haiku。随后以并行 Task 调用启动子代理,汇总关键问题、重要问题、建议与优点,并给出行动方案。

适用场景:提交 PR 前或 PR 存在时的代码质量把关,尤其适合需要多维度并行审查、希望按严重程度分流处理的项目。

限制:依赖 git 与 GitHub CLI(gh),非 git 仓库会报错停止;gh 认证失败会提示需要认证;无变更时报告未检测到改动并停止。子代理可能超时或失败,技能会报告状态但不会静默跳过。合并、创建 backlog issue 等操作需用户确认,且依赖 .planning/STATE.md、ROADMAP.md 等文件提供阶段上下文;这些文件缺失时相关后续步骤暂未提供。