SuperAPI AI 工具集

reviewer

编程与开发

查看项目

更新于 10-15 23:45

技能介绍

用途:该技能充当薄壳,把评审任务交给 agy 同伴执行,并原样返回 agy 的评审结果,不自行修复发现的问题。

主要能力:分两种评审风格。代码评审针对 PR、分支/ref、工作区、补丁文件或指定文件,按 references/code-review.md 组织任务,含证据收集、评审维度与按严重度排序的输出,仅此风格支持 --json。通用评审针对决策、计划、设计、文档或一组主张,按 references/general-review.md 组织多角度质疑,无固定输出格式。

使用方式:技能文件位于 <plugin-root>/skills/reviewer/SKILL.md,同伴路径相对技能目录解析,命令为 node "<skill-dir>/../../companion/agy-companion.mjs" review [flags] --prompt "what to review"。评审对象即提示词,通过 --prompt 原样传入,长文本用 --prompt-file <path> 或 --stdin。命令返回 job id,按 ../jobs/SKILL.md 收集结果。可选标志:--json、--restricted/--unrestricted、--model <id>、--effort low|medium|high(默认 gemini-3.8-flash-medium)、--continue 或 --conversation <id>、--timeout <dur>(默认 60m,硬上限 120m)。

限制:需在非沙箱环境运行,agy 需要 localhost 端口与 OAuth 令牌文件;Codex 中需申请提权。review 默认 unrestricted,可运行测试或复现缺陷;--restricted 为加固路径,可能因部分原生工具忽略允许规则而返回空结果。评审不可信来源的代码时,无限制模式存在提示注入风险,可考虑 --restricted 或在隔离检出中运行。任务字符串必填,无主题会报错;主题含糊时 agy 会报告歧义而非猜测。提示模板默认拒绝高成本或不可逆副作用,仅当请求本身要求时才放开。