SuperAPI AI 工具集

manager-review-existing-plan

编程与开发

查看项目

更新于 11-13 16:18

技能介绍

用途

该技能扮演独立审查经理,针对仓库中一份具体的现有实现计划,核对其实现证据与完成声明是否成立。适用于用户要求检查某份计划的执行情况、验证代码与测试是否达到计划目标、门禁与阶段顺序要求,以及判断计划状态与文档收尾是否如实反映实现现状。

主要能力

  • 建立计划基线:提取目标、范围、非目标、阶段顺序、门禁与收尾标准。
  • 收集实现证据:检查与各阶段/门禁相关的变更文件、测试与文档更新。
  • 证据映射:逐阶段验证交付物与门禁是否有具体产物支撑。
  • 顺序与逻辑评估:检查依赖顺序是否被遵守、问题解决是否连贯;若实现证据表明计划核心方案在架构上有缺陷,而非执行不佳,则标记为“计划方案失效”(P1 级发现,建议推翻重设计而非继续修补)。
  • 兼容性与清理检查:核实迁移策略、回滚安全性与删除门禁是否正确处理。
  • 文档收尾核查:验证计划状态表述、refactor_progress.md(若存在)、变更日志收尾说明与归档/收尾路由是否与实现现实一致。
  • 输出管理决定:完成、带后续项完成、未完成,并给出明确理由。

使用方式

先确认被审查的具体计划文档及其声称的完成状态。优先读取:refactor_progress.md(若目标仓库中存在)、docs/active_plans/ 下的目标计划(或指定路径,不存在则跳过)、docs/archive/ 中的相关先例(若存在)、变更文件与验证产物(git status --short、git diff、测试输出、变更日志条目)、以及 references/plan_quality_standard.md。随后按工作流执行审查,并以严重级别排序报告发现。

输出契约:先按严重级别报告发现(P1 关键、P2 高、P3 中、P4 低),每条包含计划或文件引用(路径+行号)、风险与可能影响、证据缺口或不匹配、建议的纠正措施;随后给出开放问题与未决决定、测试缺口与残余风险、文档收尾结果与收尾建议。最后必须包含“Coder Action Directive”部分,给出具体、可直接执行、有优先级的后续动作,每项注明负责角色、确切文件路径、相关命令(如适用)与完成验收标准。

适用场景

多编码者协作下需要独立管理审查时;计划声称已完成但代码/测试/文档可能仍不完整时;需要核查阶段门禁、迁移与回滚、文档状态一致性时;需要为下一步整改分配明确责任与验收条件时。

限制

  • 不编写或修改生产代码、测试或运行时配置;仅读取仓库文件、编写与更新文档产物(计划审查章节、进度跟踪、变更日志说明、收尾记录)。
  • 不得在无引用证据(代码/测试/文档/运行输出)的情况下接受“已完成”声明。
  • 除非明确要求,不得从头重写计划。
  • 需检查计划文档顶部的设计理念,确保代码变更与之对齐。
  • 发现需按严重级别排序并保持可执行性,优先处理阻塞项与高风险歧义而非风格问题。