SuperAPI AI 工具集

pr-antipattern-review

通用与其它

查看项目

更新于 10-15 17:31

技能介绍

用途:审查代码差异(Pull Request、提交或本地改动),方法是将 diff 与项目的 BLUEPRINT.md 切片目录进行对比,找出与已声明切片不符之处以及通用反模式。它是比较式而非百科式检查,不套用通用清单。

主要能力:自动识别输入格式并路由到相应命令,例如 GitHub PR 链接用 gh pr diff <URL>(回退到 .diff 抓取),GitLab MR 用 glab mr diff <N>(同样可回退),PR 编号用 gh pr diff <N>,提交 SHA 用 git show <sha>,已给的 diff 文本直接使用,无特定输入时用 git diff <base>...HEAD(回退 git diff HEAD~1)。随后按路径把 diff 归入项目与切片,加载 docs/architecture/<project>/BLUEPRINT.md、docs/architecture/BLUEPRINT.md 或 docs/BLUEPRINT.md,必要时加载 SYSTEM_MAP.md。接着逐文件解析状态、hunk、新增导入、新路径与公共 API 变化,应用切片约束(导入、命名、框架、配套文件),检查切片状态(frozen、deprecated、active)与变体,并执行通用检查:提交文件中引入密钥、清单级依赖倒置、安全回归、删除测试、吞异常、静默类型检查器等。

使用方式:以对话方式使用;发现默认只发到聊天,绝不自动写文件或自动提交,仅在用户明确要求时保存为 markdown。多项目 diff 会先询问审查范围;切片归属、新变体是否故意、严重级别存在争议时会停下来询问。最终用 path:line 格式输出,并给出总体结论。

适用场景:需要按项目既定架构约定审查 PR、且仓库已有 BLUEPRINT.md 的团队。

限制:在没有 BLUEPRINT.md 时退回通用检查,结论较弱并可能漏掉项目约定;不会生成 blueprint、不自动提交、不自动写文件,也不把通用反模式目录当作项目规则;判断类问题交由人工决定。