SuperAPI AI 工具集

soia-dev-review-panel

测试与质量

查看项目

更新于 10-16 08:51

技能介绍

soia-dev-review-panel 是一个审查方法类技能,用于对代码改动或技能包进行多视角、对抗式验证的评审。

用途

该技能的核心前提是:单个审查者存在盲区。它将一次审查结构化为多个独立的视角,每个视角寻找不同的失败模式,然后让每条候选发现经过一轮对抗式的"尝试推翻"复核后,才允许进入报告。未能通过验证的发现会被丢弃,而不是被弱化。

需要说明的是,该技能不负责拉取 GitHub PR 的 diff 或查找目标仓库自身的规则文件——那属于 soia-dev-github-ops 的 Pre-Merge Rule Review。本技能是当已有 diff 在手时被调用的审查方法论,也可以独立用于本地 diff 或技能包,完全不涉及 GitHub。

主要能力

针对代码改动:拆分为独立视角逐个审查(能并行则并行),每条候选发现再经一轮对抗式复核,只保留经得住反驳的;输出分档发现清单(阻断/应改/提示)及每条的证据等级。

针对技能包(SKILL.md/scripts/references):换用一套技能包专属视角(宿主无关性、安全门完整性、跨文件描述一致性等),输出形式同上。

报告会明确列出"检查过、没问题"的部分,而不只是报告问题,并给出覆盖范围说明。

使用方式

用户需说明审查目标:本地未提交的改动、一段已拿到手的 diff 文本,或一个技能目录路径(如 skills/<name>/)。如果目标类型不明确(代码改动 vs 技能包 vs 两者都有),技能会先询问再继续,不自行猜测。如果对严格程度有要求(如"再严一点""这次要快"),可据此增减视角数量和复核轮数;默认使用基础视角集。报告只包含经复核确认成立的发现,不自动改代码、不自动提交、不自动合并、不自动发布。

流程分为若干步骤:Step 0 确定目标类型与视角组;Step 1 列出视角清单(代码视角组或技能包视角组);Step 2 派发(支持派生独立子任务时并行,不支持时在同一上下文按顺序切换并书面声明切换视角);Step 3 按固定四要素格式化候选发现;Step 4 对抗式复核(不可省略);Step 5 输出。

代码视角组包含:正确性与自证、安全、测试覆盖与反面模式、范围与一致性。技能包视角组包含:命令/接口正确性、安全门完整性、宿主无关性、一致性与同步。需要更严格审查时可按需追加视角,但不为凑数硬加不相关视角。

适用场景

适用于需要对代码 diff 或技能包进行多角度、不漏判审查的场合,尤其是希望对每条发现进行对抗式验证、明确审查边界与覆盖范围的场景。可独立使用,也可与 soia-dev-github-ops 组合使用(由后者负责拉取 PR diff)。

限制

本技能不做编辑、提交、合并或发布,产出仅为审查建议,决定权交还使用者。它不负责拉取 GitHub PR diff,也不包含产品/团队专属信息,不假设特定模型分工。对抗式复核不可省略;"提示"级(检查过没问题)的候选不需要对抗式复核。技能包视角下的命令核实有硬性限制:只用无副作用、免登录的方式(如 --help、--dry-run、纯查询调用);需要凭据或有副作用的命令改为对照官方文档核对参数,不实际执行。

依赖与安装

安装本技能:

npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-review-panel -y

强依赖 soia-dev-coding-protocol:本技能的"测试覆盖与反面模式"视角直接复用其 Anti-Fake-Fix Gate 和提交前自审清单。安装本技能会自动带上该依赖。本技能不需要私有配置。

私密信息与中间数据

本技能不持久化任何数据,不需要凭据、cookie 或 API key。审查材料只在当前对话/子任务上下文中使用,不写入文件、日志或第三方服务。若与 soia-dev-github-ops 组合使用,凭据与网络请求边界由该技能负责。

与其他技能的关系

soia-dev-coding-protocol:强依赖。"测试覆盖与反面模式"视角复用其 Anti-Fake-Fix Gate 和提交前自审清单。

soia-dev-github-ops:单向依赖,方向相反。其 Pre-Merge Rule Review 硬依赖本技能(装不了就停下),负责拉 PR diff 并找目标仓库的规则文件,再交给本技能做视角审查和对抗式复核。本技能不反向依赖它。

soia-private-skills 的 soia-dev-code-review:不是同一技能的开源版,两者可同时安装(名字不同,不冲突)。后者专门服务已确认的 SOIA 产品 workspace 内的治理评审。