SuperAPI AI 工具集

pr-review

通用与其它

查看项目

更新于 10-15 23:58

技能介绍

用途:端到端审查 GitHub PR,并发布一条结论评论。遵循 aif 约定,加载项目上下文(RULES.md、CHECKLIST.md、config.yaml),应用上下文门禁,对 .ai-factory/* 保持只读,仅写入 PR 评论这一产物。

主要能力:检查代码整洁度(调试标记、TODO/FIXME、死代码、不可达分支、注释掉的代码、乱码);检查重复(DRY 违规、N+1、重复块、跨包重复);检查文档同步(README、docs/**、CLAUDE.md 同步规则);检查 CHECKLIST.md 与 RULES.md 合规;评估 PR 体积并建议拆分;识别高风险变更是否需默认关闭的特性开关;输出架构、规则、路线图门禁结论。

使用方式:参数为 PR URL 或编号。先读取 .ai-factory/config.yaml 解析路径、语言、基础分支,缺失则用默认值;并行加载 DESCRIPTION.md、ARCHITECTURE.md、RULES.md、CHECKLIST.md、CLAUDE.md,并强制读取 .ai-factory/skill-context/pr-review/SKILL.md(若存在,其规则优先)。用 gh pr view 获取元数据,检测 head 仓库以支持 fork。通过评论与审查记录判断模式:无本人历史评论为全新模式,审查完整 diff;有则为跟进模式,仅审查上次审查后的新提交,并将旧发现分类为已解决、未解决或已失效。随后按文件分类表执行各项检查,汇总严重级别(must-fix、should-fix、nit),据条件给出 APPROVE、REQUEST_CHANGES 或 COMMENT 结论并起草评论。

适用场景:GitHub 仓库的 PR 审查流程,尤其适合有项目规则、检查清单与文档同步要求的团队。

限制:非 lint 替代品,假定 CI 已覆盖格式、类型与编译错误;仅关注需人工判断的问题。依赖 gh CLI 与 GitHub API。评论语言、路径、基础分支等由配置决定,默认英语、.ai-factory/、main。具体收费、平台支持范围等资料暂未提供。