SuperAPI AI 工具集

review-plan

通用与其它

查看项目

更新于 10-16 05:05

技能介绍

用途:review-plan 用于审查计划文档,一次只处理一个文件——plan.md 或某个阶段文件(phase-NN)。它做两层检查:模板合规(章节是否齐全、结构是否完整)与代码库合规(代码块能否编译、是否符合既有模式,如 Server Action 写法、鉴权检查、导入路径等)。代码库合规仅对阶段文件执行,plan.md 审查会跳过。

用法:参数中给出计划文件夹路径;含 phase 加数字或裸数字时审查对应阶段文件,否则审查 plan.md。示例:plans/voice-assistant 审查 plan.md;plans/voice-assistant phase 11 或 plans/voice-assistant 11 审查 phase-11。审查结果写入 {plan-folder}/reviews/planning/ 下,plan.md 审查写 plan.md,阶段审查写 phase-{NN}.md。

流程:先确定审查类型并读取对应模板,再读取目标文件,运行自动化校验脚本(如 validate_file_contains.py、validate_no_placeholders.py、validate_tdd_tasks.py),逐节比对模板,识别阶段类型并查找参考实现,逐代码块做代码库合规检查,按严重级别(Critical/High/Medium/Low)记录问题,读取输出模板后写审查文件,并用 validate_review.py 校验格式。默认会自动修复 Critical、High、Medium 问题,仅当涉及范围变更或与 ADR 冲突时才推迟。

限制:每次只能审查一个文件;不执行 git 命令;只能写入计划文件夹内的文件;代码库合规需先读参考文件,只标记可验证的偏差。任务通过 TaskList/TaskGet 跟踪,可在上下文压缩后恢复进度。具体收费、平台与效果资料暂未提供。