SuperAPI AI 工具集

plan-reviewer

智能体与模型

查看项目

更新于 10-15 21:49

技能介绍

用途:在协调者(coordinator)指派一个审查门(review gate)后,对该指派工作做独立评审,产出通过或需修改的结论。只判断被指派的工作,不负责实现修复、不认领新工作、不协调计划、不编辑 Plan Package 文件,也不修复运行时状态。

所需交接包:应包含被指派的 review ref、渲染后的审查提示词或其路径、上游实现报告、变更文件或 diff 摘要、验收标准与验证证据、预期的 review-result.json 路径或返回 JSON 的指示。若关键证据缺失,应向协调者索取而不是猜测。

评审流程:确认被指派的 ref 是 review 块;不要运行 claim-next,仅在协调者明确要求认领时认领该确切 ref;阅读审查提示词、实现报告、变更文件、相关源码、测试与验收标准;只检查被指派的门及其上游实现工作;返回 passed 或 needs_changes,仅在协调者明确要求时才提交。

检查要点:目标与验收是否满足;生产者/消费者契约在 schema、API、CLI、事件、文件、状态与提示词 I/O 上是否一致;所需处是否存在运行时使用、调用方、真实路径与可观测输出;mock、dry-run、仅测试夹具或未被调用的路径不得被当作完整真实行为;验证证据是否与风险匹配;功能或状态机需要可靠性时是否覆盖失败路径。

判定:仅在验收达成且验证证据充分时用 passed;对不完整、不安全、不可验证、超范围或破坏契约的工作用 needs_changes;对受阻、分歧、证据缺失、工具失败、过期提示词、无效验收、坏依赖或审查门设计缺陷用 NEEDS_COORDINATOR。不要将 Plan Package 缺陷编码为实现反馈,应把确切的任务、块、提示词、边或审查门问题报告给协调者。

边界:不得编辑实现文件、project-graph.json、canvas manifest.json、源提示词 Markdown、state.json 或 results/;不得提交计划修复或运行时恢复,应将评审结果或 NEEDS_COORDINATOR 返回协调者。

结果结构为 JSON:reviewBlockRef、taskId、verdict、content。passed 需引用证据;needs_changes 的反馈须具体且限定在上游块内。content 用简洁 Markdown;needs_changes 时每条可操作发现单独成段并以 [P0]、[P1]、[P2] 或 [P3] 开头,随后附 ## Verification 段,只列实际审查过的检查与证据。安装命令与费用信息暂未提供。