SuperAPI AI 工具集

pr-review

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:面向 microsoft/winappcli 仓库的 PR 或功能分支做多维审查。当贡献者提出“review my PR”“review my changes”等请求时激活;若只是“review this function”或“is this line correct”这类单点提问,则不适用。

主要能力:

  1. 获取差异。默认执行 git --no-pager diff origin/main...HEAD;若工作区有改动且分支无新提交,改用 git --no-pager diff HEAD,并用 git ls-files --others --exclude-standard 纳入未跟踪文件。基准依次回退 origin/main → main → origin/HEAD,均不可解析则停止询问。记录文件列表与完整统一 diff;0 个文件则说明并停止;超过 50 个文件先警告并询问。判断是否为复审。
  2. 并行分发。用 task 工具以 sync 模式一次性启动审查者,每个提示自包含:角色、diff、该审查者负责的变更文件,以及 dimensions/_shared-contract.md 与 dimensions/<name>.md 全文。审查维度包括 security、correctness & tests、cli-ux、alternative-solution、ship-surfaces,以及按条件启用的 necessity & simplicity。随后以 model override 启动 multi-model(dimensions/multi-model.md),选用与自己不同家族的最新模型,仅传入 diff 与真实变更文件。若某子代理被阻断,仍继续返回发现,失败则加固重试。
  3. 汇总去重:按同文件、重叠行、同一根因合并,保留更高严重级别;复审时舍弃中低优先级。
  4. 把关:删除仅属“更整洁替代方案”、修复成本高于问题成本、防护不可能发生情况、无用户可见效果的条目;安全、数据丢失、崩溃、错误输出、安装失败不删。普通 PR 幸存条目超过约 6 条则重审。
  5. 实际验证:构建(scripts/build-cli.ps1 或定向 dotnet build),按用户方式运行(dotnet publish 后直接调用二进制,避免 dotnet run 的 Debug 工作区),对临时目录中的一次性应用执行变更命令,UI 自动化需驱动真实窗口,并按安全审查者描述做红队尝试。标注已验证、已反驳或仅静态。
  6. 报告:输出到 stdout,不写文件、不发 PR 评论、不擅自修复。结构为决策、必须修复(仅严重/高)、非阻塞(中/低)、已验证内容。若被要求修复,仅改严重与高,之后停下询问;授权修复默认放入现有 PR。若被要求发 PR 评论,须以指定 AI 生成横幅开头,且不得泄露内部发现编号、轮次或覆盖表。

限制:仅适用于该仓库;报告为主,不自动提交评论、标签或修复;部分验证需证书、硬件、管理员权限或示例应用,资料中未提供具体依赖细节。