用途:在编写实施计划之后(如 superpowers:writing-plans 的输出),或在用户说“review plan”“检查我的计划”“给计划做个合理性检查”时使用。目标是在计划执行前发现缺陷,而不是验证计划正确。
主要流程:
- 定位计划:按顺序检查显式参数(用户给出的文件路径)、对话上下文、计划目录中的最新 .md 文件,命令为 ls -t .dev/cdt/plans/.md docs/plans/.md 2>/dev/null | head -1(需在仓库根目录运行)。找不到时用 AskUserQuestion 询问。
- 代码库校验:逐项核对计划中的具体声明,包括文件路径(修改/删除)、待创建文件、行号、API 签名、相对导入路径、重复实现、测试文件,并按 Critical/Warning/Note 记录结果。
- 启动顾问:并行调用 council:gemini-consultant 与 council:codex-consultant,发送相同提示词;发送前先做密钥扫描(如 gitleaks detect --source . --no-git),检测到密钥则中止,不发送计划内容。顾问从错误假设、缺失边界情况、更简单替代方案、依赖风险、安全与性能、范围蔓延等维度审查,并按要求返回 JSON 格式的 findings。
- 去重与综合:合并两位顾问重复指出的问题(标注“flagged by both consultants”),保留单方发现的分歧项,保留全部 Critical 项,按严重程度排序。
- 结构化输出:包含代码库校验结果、Critical/Warning/Note 问题、顾问分歧,以及结论(Ready to execute、Needs revision 或 Needs discussion)。
- 按结论处理:可执行时提供交接(如 /cdt 或 superpowers:executing-plans);需修改时列出具体改动并询问是否修改或承担风险继续;需讨论时列出权衡,由用户决定。
错误处理:一位顾问失败则用另一位继续并注明置信度降低;两位都失败则仅用代码库校验结果并建议人工审查;计划缺具体文件引用时跳过校验直接进入顾问环节。
限制与不适用:不适用于单文件、少于 5 行的琐碎计划;已审查过的计划;或用户明确说“跳过审查”“直接执行”的情况。其他收费、平台与效果信息暂未提供。