用途:agy-reviewer 通过 agy 获取第二意见评审,评审对象可以是代码(PR、分支/ref、工作树、补丁文件、指定文件),也可以是决策、计划、设计、文档或一组主张。它本身只是薄壳:组织任务、运行配套程序、原样返回 agy 的评审,绝不修复其发现的问题。
主要能力:分两种风味。代码评审需阅读 references/code-review.md 并按其中要求组织任务(证据收集、评审维度、按严重度排序输出),--json 仅属于此风味。通用评审需阅读 references/general-review.md 并按其中要求组织任务(多角度质疑),无固定输出格式,如需特定形式应在任务中说明。
使用方式:技能文件位于 <plugin-root>/opencode-skills/agy-reviewer/SKILL.md,配套程序路径相对技能目录解析:node "<skill-dir>/../../companion/agy-companion.mjs" review [flags] --prompt "what to review"。评审对象即提示词,通过 --prompt 原样传入;长文本用 --prompt-file <path> 或 --stdin。命令需在非沙箱环境运行,因为 agy 需要 localhost 端口和 OAuth 令牌文件;在 Codex 中需请求提权。命令返回 job id,结果收集与恢复参见 ../agy-jobs/SKILL.md:派发、等待最终结果、按需校验,不要主动观察进度或读取日志。
可选标志:--json(仅代码评审风味,输出 schema 约束的 JSON 发现);--restricted / --unrestricted(权限配置,review 默认 unrestricted,--restricted 为加固路径,可能因部分原生工具忽略允许规则而返回空);--model <id> / --effort low|medium|high(默认 gemini-3.8-flash-medium);--continue 或 --conversation <id>;--timeout <dur>(默认 60m,硬上限 120m);--prompt / --prompt-file / --stdin 三选一。
限制与注意:评审不受信任作者的内容时,无限制评审可能因提示注入执行任意命令,建议使用 --restricted 或在隔离检出中运行。任务字符串必填,无主题会报错;主题含糊时 agy 会报告歧义而非猜测。提示模板默认拒绝高成本或不可逆副作用,只有请求本身明确要求时才放开,因此应把“run the e2e tests”等授权原样保留在提示中。--restricted 返回空时转达配套程序指引。已有对话的 --continue / --conversation 会继承其记录的模型与权限配置,除非显式覆盖。若环境缺少所需工具,应使用可用能力达成等价结果,仅调整工具相关执行方式,保留任务目标、授权要求、确认步骤、结果交付与停止条件;无法等价时应说明缺失能力及影响并请求用户帮助。