SuperAPI AI 工具集

plan-review

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:在计划进入实现前自动审查实施计划的有效性、正确性与最佳实践,属于计划阶段的门禁技能,不是面向用户的访谈式校验。

主要能力:按顺序执行 Phase 0 检测计划类型,读取 plan.md、goal.md 与全部 phase-*.md,提取需求、步骤、文件与风险;从有效性、正确性、最佳实践、完整性四组清单评估,并应用 11 项对抗性技术、反偏见门与 8 个计划维度;在存在 graph.db 时对修改文件做图追踪;输出 PASS/WARN/FAIL 评分。核心原则是“足够详细且足够小”:每阶段不超过 5 个文件、不超过 3 小时、不含规划类动词,过于模糊则细化,过大则拆分。

使用方式:通过 $plan-review 调用,参数可为计划路径或当前活动计划。发现任何问题后,先用 $why-review --validate-findings 验证发现,只修复已验证的问题,再以全新零记忆子代理重跑完整审查。第 1-2 轮要求零发现,第 3 轮起仅要求零 CRITICAL/HIGH/MEDIUM,仅剩 LOW 即结束循环并记录为延迟项;最多 3 轮,同一阻塞连续两轮无进展或第 3 轮仍有未决问题则升级询问用户。

适用场景:实现前的计划门禁、bugfix(强制行为差异矩阵)、安全、性能、重构、契约、基础设施、数据模式等类型计划的审查。

限制:需要项目文档与计划文件存在,缺失或过期时需先运行 $project-init 等初始化路由;部分步骤依赖子代理与任务跟踪工具,环境不支持时应停止并询问用户;严重度分级依据 SYNC:severity-rubric,不得为达标而降级真实问题。