SuperAPI AI 工具集

review-readiness

智能体与模型

查看项目

更新于 10-16 02:40

技能介绍

用途:判断 RNA 上下文是否能让某个 PR 或工作区 diff 更易审查,并产出最小可用的审查地图。它是技能而非固定报告生成器,由智能体自行选择探针,目标是回答原始 diff 难以低成本回答的问题:哪些变更符号在结构上重要、审查者应检查哪些调用方/结果/护栏/文档、哪些缺失元数据真正阻塞审查、RNA 在哪里增值、哪里纯 diff 已足够。若 RNA 无价值,应直接说明并基于 diff 审查。

参数:$ARGUMENTS 可指定待检查变更。空为当前工作区 diff;--base main 表示 main...HEAD;--base <sha1> --head <sha2> 为显式范围;--pr 660 为 GitHub PR diff。

流程:第一步获取 diff 形态,用最省成本的来源(git diff --stat、git diff -- <path>、gh pr view、gh pr diff 等),按代码/测试/文档/.oh 产物/配置分类汇总,标注增删改重命名、hunk 行范围及是否映射到已提取符号,不粘贴完整 diff。第二步先问图谱上下文能改善哪个审查决策,再决定是否查询 RNA;涉及非显然调用方、公开接口变更、提取器/图谱/扫描器/服务/服务器/查询边界、结果/护栏/ADR 关联或需要影响与风险时使用,纯文档、自包含明显变更或图谱无索引符号时跳过并说明。第三步选择性探测,优先用 repo_map、search(compact、neighbors、impact)、outcome_progress 等仓库原生工具,将当前侧 hunk 范围映射到已提取符号并记录稳定节点 ID;小 diff 两三个探针即可,不运行全仓 LSP、嵌入或广泛增强。第四步分类审查就绪度:Ready、Partial、Blocked,并精确说明缺失事实而非泛泛抱怨。第五步输出审查地图,含 Diff Shape、Hunk Map 表格、RNA Added Value、Review Anchors、Readiness、Recommended Next Step。

护栏:不得由行重叠或干净 diff 声称语义完整;不运行全局死代码分析;不要求首轮审查前完成全仓 LSP;不隐藏 RNA 无价值这一有效结果;不替代测试、编译器检查或强制的独立最终 diff /review 批准。该技能与 #659 相关,把就绪度做成面向 PR 审查任务的具体判断,昂贵提供者如 LSP 仅用于其独有能回答的问题。