SuperAPI AI 工具集

review

测试与质量

查看项目

更新于 10-16 06:43

技能介绍

用途:该技能用于按需运行代码质量审查智能体,可审查手动编写的代码、评估现有代码库,或在合并前检查某个分支。

主要能力:先解析审查范围;若未提供路径,则运行 ${CLAUDE_SKILL_DIR}/scripts/detect-review-scope.sh 检测分支差异。默认并行运行四个智能体:@vgv-review-agent、@code-simplicity-review-agent、@test-quality-review-agent、@architecture-review-agent,分别生成 vgv-review.md、code-simplicity-review.md、test-quality-review.md、architecture-review.md。项目可在 CLAUDE.md 中追加或替换默认智能体列表。每个智能体将完整报告写入 <PWD>/docs/code-review/<name>.md,仅向父上下文返回含 Critical、Important、Suggestions 计数的简短摘要。所有审查完成后,技能会按三类汇总并以一行描述呈现;若无发现则提示代码看起来良好。

使用方式:提供文件或目录路径可直接限定范围;未提供时脚本会检测分支差异,若在默认分支且无差异,则通过 AskUserQuestion 询问要审查什么。审查后可用 AskUserQuestion 选择:自动修复严重问题、修复严重与重要问题、仅查看发现列表、或保留报告退出。修复仅限原审查范围内的文件,并通过项目 linter 和测试运行器验证,每个修复只尝试一次。

限制与注意事项:报告为 docs/code-review/ 下的未跟踪工作文件,同名旧报告会被覆盖,需要干净状态应先删除该目录。默认分支无差异时范围不明确,必须让用户指定,不应擅自审查整个项目。单个智能体失败不影响其他智能体,但必须报告失败项。修复需要改动范围外文件时应向用户说明,而非擅自扩大范围。该技能为建议性质,发现问题后由用户决定采取何种行动。