SuperAPI AI 工具集

review-panel

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:对明确的 base 与 head 执行一次 pi-review-panel 审查并生成报告;也可用于对整个仓库做周期性的顾问式审计。工具本身不修复、不提交、不做合并决策,由使用者判断、仓库所有者合并。

主要能力与动作:

  • diagnose:在不确定环境是否就绪时调用,例如 { "action": "diagnose" };若进程已在仓库内可省略 repository。
  • review:调用 { "action": "review", "base", "head" },可选 lenses、seats 和 scopingNote;lenses 与 seats 必须是 JSON 字符串数组(如 ["security"]),不能是字符串化的数组。审查会诊断并在环境损坏时拒绝执行,因此不要用 {} 调用。
  • verify:修复后需先提交,使 head 成为新 OID(未提交内容不可见);再调用 { "action": "verify", "repository", "priorRunId", "head", "keptFindingIds" }。priorRunId 为审查记录路径中的运行目录名或完整记录路径;keptFindingIds 是保留项列表(含提升的 low)。
  • comment:仅在负责人确认后调用 { "action": "comment", "repository", "priorRunId", "ownerApproved": true },可带 pr、dismissed、lowAdvisory、verifyRunId;工具会找到作者为本人且正文含 ## Review panel 标题的评论并更新,不新开线程。
  • audit:对整个固定仓库做顾问式扫描,无 base/head;默认运行 code-health、over-engineering、tests、security 于前两个默认席位,可用 passes 指定目标菜单(如 {"action":"audit","passes":["docs","operability"]})。审计不写 AUDIT.md、不修文件、不跑 CI、不发 GitHub 评论;如需可自行写 AUDIT.md 作为面向所有者的待办清单。

Lenses 触发条件(仅当能指向匹配文件或具体竞态、缓存、时钟时才加):security(新认证、加密、子进程或信任/路径边界)、tests(行为变更但覆盖薄弱)、contracts(OpenAPI、proto、GraphQL;TOML 或应用配置模式不算)、privacy(隐私/PII 命名路径)、migrations(SQL 或迁移路径)、subtle-correctness(竞态、缓存、时钟、过期读)、correctness(通用逻辑与边界)、specification-conformance(需在 scopingNote 提供验收要求)、infrastructure(CI、Docker、Terraform)。silently 跳过应触发的 security lens 属于漏检;大 diff(数十文件或数千行)需在 scopingNote 指明关键文件。

判断与停止规则:席位严重度是意见。默认保留 high 与认同的 medium,默认跳过 low/建议/琐碎项;可提升真实 low 为保留阻塞项,或丢弃已核实的高危项并说明理由,但不要修复它。最多三轮模型轮次:发现为第一轮,修复+验证为第二轮,若验证仍有问题或修复引入新 bug 可再做一轮;脏的第三轮停止并询问所有者,不得进入 review-fix-review-fix 循环,也不得对同一变更再次启动完整发现小组。

合并建议:在干净验证或无需保留的发现报告后,可告知所有者变更看起来可落地,并说明谁投票、谁失败、保留或跳过什么。审查不等于授权编辑,仅在所有者要求含修复的审查或事后要求修复时才修复。