SuperAPI AI 工具集

audit-plan

编程与开发

查看项目

更新于 10-15 20:32

技能介绍

audit-plan(Plan Flow Audit)是一个用于多阶段实施计划的结构化流程审计技能。它评估各阶段是否作为流水线连贯衔接,而不检查单个阶段是否符合模板——后者由 /review-plan 负责。其定位是在逐阶段评审之前运行,关注计划设计的合理性,而非模板完整性或占位内容。

用途:在实施前发现仅在整份计划层面暴露的结构问题,如循环依赖、缺失依赖、顺序错误、过时产物、数据流不一致。

主要能力:读取 plan.md 与全部 phase-*.md 文件;提取阶段号、标题、状态、依赖、产出与消费内容、目标文件;构建依赖图并执行 bail-out 检查(循环依赖、超过半数依赖缺失或错误、无连贯执行顺序、无可辨识架构时提前终止并给出 Unusable 结论);评估数据流一致性、阶段顺序、过时产物与待办阶段风险。

使用方式:通过参数 $ARGUMENTS 传入计划文件夹路径(如 plans/detector-refactor),无需让用户重复提供。任务开始前可用 TaskList 检查已有任务,按 pending 或 in_progress 继续。报告写入 {plan-folder}/reviews/planning/flow-audit.md,目录不存在则创建。可选运行占位符校验器(命令原文):echo '{"cwd":"."}' | uv run $CLAUDE_PROJECT_DIR/.claude/hooks/validators/validate_no_placeholders.py --directory {plan-folder} --extension .md。

适用场景:多阶段实施计划的开工前结构审计,其结论会影响 /implement 是否继续或退回规划器。

限制:源文件只读,仅写审计报告;必须读取全部阶段文件;需用 Glob 对照代码库核实文件是否存在;不做模板检查;容忍粗糙边缘,仅在占位内容影响结构意图时标记。关于具体价格、平台或收费信息,资料暂未提供。