SuperAPI AI 工具集

workflows-plan-review

办公与效率

查看项目

更新于 10-16 09:30

技能介绍

用途:在动手实现之前审查实现计划,做压力测试、范围挑战和可行性复核,适用于用户提出计划评审、范围挑战或可行性复核等请求。该技能只做评审,不实施计划,也不编辑产品代码。可用工具与评审角色见 RUNTIME_TOOLS.md;共享的权限、委派、模型、Git 与评审策略以 agents/shared/AGENTS.md 为准。

主要能力:从用户消息、指定文件或当前对话中解析计划,可处理单文档、多份关联文档,或规格加结构化工作项;读取计划声明为规范性的全部文档。若无法识别计划或目标,只问一个聚焦问题;否则基于已有证据开始,不要求用户重复对话或仓库中已有的上下文。先做证据搜集:识别目标、约束、验收标准、受影响系统、发布边界与未决事项,检查仓库说明与最小相关代码、测试、配置和历史,涉及框架、外部 API 或平台规则时查权威文档,并区分已确认的仓库事实、计划陈述、假设与未知项。

使用方式:按用户指定的模式评审——EXPAND 找出值得扩大范围的更优结果,SELECTIVE 保留范围只给高价值补充,HOLD 不改变既定范围做严格检验,REDUCE 找仍满足目标的最小完整方案;未指定时默认 HOLD。范围变更只是建议,需说明取舍并在改写计划前询问。评审轴包括问题契合、复用与边界、行为、数据、接口、安全与隐私、性能与运维、执行、验证。对重要流程做失败分析,必要时用精简失败表或小图辅助。发现按实际影响分级:P0 不安全、P1 必须修复、P2 有明确失败或维护成本的改进、P3 可选打磨;每条需给出计划或仓库证据、触发与可观察后果、未覆盖原因及最小修正。

限制:无资料处暂未提供。默认在对话中返回评审,含结论、确认的优点、分级发现、范围选项、未决问题和验证检查。除非用户明确要求,不创建或更新 spec.md、prd.json、待办文件、分支、提交、拉取请求或外部评论;若要求修改计划文件,只应用已接受的改动并报告具体变更文件。同一未决问题在两次评审循环后仍出现即停止,说明待决事项与所需证据。