SuperAPI AI 工具集

plan-plus

编程与开发

查看项目

更新于 10-16 02:11

技能介绍

Plan Plus 是 bkit-claude-code 提供的一项规划技能,全称为“Brainstorming-Enhanced PDCA Planning”。它把头脑风暴中的意图发现方法与 bkit PDCA 的结构化规划结合起来,通过协作式对话产出质量更高的 Plan 文档。

用途

Plan Plus 在标准 /pdca plan 的基础上,在文档生成之前增加了 4 个头脑风暴阶段,确保在开始实现之前充分理解用户意图、探索可选方案,并移除不必要的功能。

适合在以下情况使用 Plan Plus 而非 /pdca plan:

  • 功能需求模糊或复杂
  • 存在多种可能的实现方式
  • 希望从一开始就确保符合 YAGNI 原则
  • 功能涉及重要的架构决策

流程

Phase 0:上下文探索(自动) Phase 1:意图发现(每次一个问题) Phase 1.5:前提挑战(强制性问题、确认前提) Phase 2:方案探索(2-3 种方案,含“什么都不做”) Phase 3:范围模式 + YAGNI 审查(multiSelect 验证) Phase 4:增量设计验证(逐节确认、失败映射) Phase 5:Plan 文档生成(plan-plus.template.md) Phase 6:后续步骤 → /pdca design {feature}

各阶段说明

Phase 0:项目上下文探索(自动)。在提问之前先了解项目现状:读取 CLAUDE.md、package.json、pom.xml 等项目信息;查看最近 5 次 git 提交;检查已有 docs/01-plan/ 文档以防重复;检查进行中的 PDCA 状态(lib/pdca/status.js 中的 getPdcaStatusView(),读取 .bkit/state/pdca-status.json)。随后简要分享探索结果。

Phase 1:意图发现。原则是每次只问一个问题,优先使用多选。通过 AskUserQuestion 工具依次发现:核心目的、目标用户、成功标准、约束条件(仅在需要时)。清晰的功能只需 Q1-Q2,模糊的功能才继续 Q3-Q4。

Phase 1.5:前提挑战。Phase 1 记录用户想要什么,本阶段检验是否值得以该形态构建。每次提出一个强制性问题:F1 需求(谁会在下个月没有它时真正不满)、F2 现状(用户今天如何勉强完成)、F3 切入点(本周就有人用的最小版本)、F4 什么都不做(不构建会发生什么)。新产品或面向用户的能力问 F1-F4;内部工具或重构问 F2、F4;缺陷修复或小改动跳过本阶段。结束时打印确认前提的编号列表,请用户确认;若前提被否决,需先修订再进入 Phase 2。

Phase 2:方案探索。始终提出 2-3 种方案并列出各自权衡,推荐方案放在最前并说明理由,通过 AskUserQuestion 让用户选择。

Phase 3:范围模式 + YAGNI 审查。先选择范围模式:Expand(绿地工作,最多 3 项高价值低成本的补充)、Selective(现有产品上的新能力,逐项提供补充)、Hold(修复或规模已合适的计划,不做补充)、Reduce(计划超过约 15 个文件或涉及多个子系统时,削减到 Phase 1.5 的切入点)。每个补充项单独决定:现在加入、推迟(记录在 3.2 Deferred)或放弃。随后对选定方案执行 YAGNI 审查,使用 multiSelect 让用户只勾选第一版必需项,未勾选项移入 Out of Scope。

Phase 4:增量设计验证。逐节展示设计并逐节获得批准:架构概览、关键组件/模块、数据流、失败映射。失败映射列出每个新入口点(端点、命令、任务、UI 操作),追踪其输入为空、无效或依赖失败时会发生什么,任何“未处理”且静默失败的行都必须给出处理决策或列为已接受风险。

Phase 5:Plan 文档生成。使用 plan-plus.template.md 生成文档,包含标准模板之外的附加章节:User Intent Discovery、Premise Challenge、Alternatives Explored、YAGNI Review、Failure Map、Brainstorming Log,以及自动综合的 Executive Summary(问题/解决方案/功能体验效果/核心价值四视角)。生成后必须在回复中同时输出 Executive Summary 表格。输出路径为 docs/01-plan/features/{feature}.plan.md。生成后由 Stop 钩子(scripts/plan-plus-stop.js)记录阶段并创建 Task 链,不要手动写入阶段。

Phase 6:后续步骤。完成后提示下一步为 /pdca design {feature}。

与 PDCA 的集成

Plan Plus 产出与 /pdca plan 相同的输出,可无缝接入标准 PDCA 循环:/plan-plus {feature} → /pdca design {feature} → /pdca do {feature} → /pdca analyze {feature} → /pdca report {feature}。

使用示例

/plan-plus user-authentication /pdca design user-authentication /pdca do user-authentication

限制

资料未提供该技能的收费、价格、平台支持范围或效果数据。