SuperAPI AI 工具集

read-only-gh-pr-review

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:对后端 PR 做端到端审查,结合本地代码分析与 GitHub CLI API 调用,只报告可执行、高信号的发现。

主要能力:覆盖安全、正确性、数据完整性、API 兼容性、性能与测试充分性,按风险优先排序;可读取 PR 元数据、diff、变更文件、评审、检查与评论,并深入检查请求处理器、业务服务、授权逻辑、数据库查询、迁移、后台任务与队列/事件处理器,验证幂等性、事务安全、并发、重试与公共 API 向后兼容。

使用方式:仅使用 SemanticSearch、WebSearch、Grep、LS、Glob、Read、Shell、GitHub CLI。执行任何 gh 命令前先启用只读环境:source "<SKILL_DIR>/scripts/activate-gh-readonly.sh",将 <SKILL_DIR> 替换为该技能目录的绝对路径。随后 gh 命令会被只读包装器拦截。先用 gh auth status 验证认证,未认证则请用户运行 gh auth login。始终强制只读,禁止评论、评审、编辑、指派、合并、关闭、重开或任何 API 变更;若命令被拦截,不要尝试可改变状态的替代方案。

工作流:启用只读环境;确认身份与认证(gh auth status、gh api user);解析仓库 owner/name 或传 -R <OWNER>/<REPO>;用 gh pr view <PR_NUMBER> [--json <fields>] 或 gh pr list 定位 PR;从 headRefName 获取分支后运行 git fetch --prune origin <HEAD_BRANCH>,基于 FETCH_HEAD 审查;收集元数据、diff、变更文件、评审、检查与评论;本地读取高风险文件并与 diff 关联;按 references/review-checklist.md 应用清单;输出仅含聊天,不写回 GitHub。

输出格式:按 Critical Issues、Important Issues、Suggestions 分节,每条含 Issue、Location(file:line)、Severity、Facts、Assumptions、Problematic Code、Suggestion、Example。必须区分已验证事实与假设,依赖假设的发现需条件化表述;无法验证的怀疑应作为问题提出或丢弃,不得编造行号、符号、代码或行为。

限制:严格只读;证据不完整时需说明;命令映射见 references/github-cli-map.md。具体安装方式与更多配置暂未提供。