SuperAPI AI 工具集

pre-push-review

通用与其它

查看项目

更新于 10-15 17:18

技能介绍

用途:在提交推送到远程仓库前,对尚未推送的提交进行代码审查与修复。

主要能力:先用 git diff origin/<branch>..HEAD 获取未推送改动的完整 diff;若尚无远程跟踪分支,则与 origin/main 比较。随后尝试在当前分支名与 specs 目录中定位对应功能规格,读取其中的需求、设计、任务与决策日志。若存在规格,则平行启动四个审查代理:代码复用审查(查找可复用的既有工具函数、重复实现、可用现成工具替代的内联逻辑);代码质量审查(冗余状态、参数膨胀、近似重复代码、泄漏抽象、字符串硬编码等);效率审查(重复计算、遗漏并发、热路径负担、不必要的存在性检查、内存与监听器泄漏、过宽操作);规格与文档审查(实现与规格的一致性、文档更新、测试缺口)。若无规格,则只做通用审查。

使用方式:等待所有代理完成后汇总并直接修复问题;修复不得以修改测试为代价,误报可直接跳过。随后运行项目测试套件(如有 Makefile 命令则使用)与 lint/校验;若测试失败,应排查是否为修复引入的回归,不得改测试使其通过。接着调用 explain-like 技能生成初、中、高三级实现讲解,并从中提取重要改动、可复用经验与决策理由;若某非平凡决策找不到理由,列为待作者确认的问题,不得编造。最后用脚本 python3 ~/.claude/scripts/build_review_html.py --data /path/to/review.json --output /path/to/pre-push-review.html --diff-dir /path/to/diff-fragments 渲染自包含 HTML 审查页,输出位置优先为 specs/{feature_name}/pre-push-review.html,其次 {repo-root}/.claude/pre-push-review.html,否则 /tmp/pre-push-review-{branch-name}.html。

适用场景:本地功能分支推送前的自检,尤其是存在规格文档、希望同时检查代码复用、质量、效率与规格一致性时。

限制:需要 Claude 类智能体环境及 Agent、Skill、Grep 等工具;HTML 渲染依赖上述本地脚本。安装方式、客户端配置、收费与价格等资料暂未提供。若未检测到规格文档,则只进行通用审查,不产出规格一致性评估。渲染时若 diff 片段或 JSON 缺失,页面仍会生成并给出占位提示。资料未说明该技能支持的具体语言或平台范围。