plan-plus

Plan Plus — 增强头脑风暴的 PDCA 规划

将头脑风暴中的意图探索与 bkit PDCA 的结构化规划相结合，通过协作对话生成 更高质量的 Plan 文档。

概述

Plan Plus 在标准 /pdca plan 之前增加 4 个头脑风暴阶段，然后再生成文档。这样可以确保在开始任何实现之前，充分理解用户意图、探索各种方案，并移除不必要的功能。

在以下情况下，使用 Plan Plus 代替 /pdca plan：

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

HARD-GATE

在整个流程完成且用户批准 Plan 文档之前，不要编写任何代码、搭建任何项目框架，也不要调用任何实现技能。 无论功能看起来多简单，这都适用于每一项功能。 即使是“简单”功能，也必须经过此流程——设计可以简短， 但必须展示设计并获得批准。

流程

Phase 0: Context Exploration (automatic)
    ↓
Phase 1: Intent Discovery (1 question at a time)
    ↓
Phase 2: Alternatives Exploration (2-3 approaches)
    ↓
Phase 3: YAGNI Review (multiSelect verification)
    ↓
Phase 4: Incremental Design Validation (section-by-section)
    ↓
Phase 5: Plan Document Generation (plan-plus.template.md)
    ↓
Phase 6: Next Steps → /pdca design {feature}

阶段详情

阶段 0：探索项目上下文（自动）

在提问之前，先探索当前项目状态：

1. 阅读 CLAUDE.md、package.json、pom.xml 等文件，了解项目信息
2. 查看最近 5 次 git 提交（了解当前工作方向）
3. 查看现有的 docs/01-plan/ 文档（避免重复）
4. 查看 .bkit-memory.json（检查正在进行的 PDCA 状态）

简要分享探索结果：“我已查看当前项目状态：……”

阶段 1：发现意图（头脑风暴风格）

原则：一次只问一个问题，优先使用选择题

使用 AskUserQuestion 工具按顺序了解以下内容：

Q1. 核心目的

“此功能要解决的核心问题是什么？”

• 提供 3-4 个选项（根据项目上下文推断）
• 始终提供自定义输入选项

Q2. 目标用户

“主要由谁使用此功能？”

• 管理员 / 终端用户 / 开发者 / 外部系统

Q3. 成功标准

“哪些标准可以表明此功能取得了成功？”

• 推导出具体、可衡量的标准

Q4. 约束（仅在需要时）

与现有系统的冲突、性能要求、技术约束等。

重要：尽量减少提问。需求明确的功能只需回答 Q1-Q2。 只有需求含糊时，才继续询问 Q3-Q4。

阶段 2：探索备选方案（头脑风暴核心）

始终提出 2-3 种方案，并说明每种方案的权衡。

格式：

### Approach A: {name} — Recommended
- Pros: ...
- Cons: ...
- Best for: ...

### Approach B: {name}
- Pros: ...
- Cons: ...
- Best for: ...

### Approach C: {name} (optional)
- Pros: ...
- Cons: ...

首先提出推荐方案，并清楚说明理由。 使用 AskUserQuestion 让用户选择。

阶段 3：YAGNI 审查（头脑风暴核心）

对选定方案进行 YAGNI（You Ain't Gonna Need It）审查：

使用 AskUserQuestion，并设置 multiSelect: true： “仅选择第一个版本必不可少的内容：”

列出所有功能，并将未选中的项目移至“范围外”。

原则：能用 3 行代码完成的事，不要抽象。 不要为假设的未来需求进行设计。

阶段 4：增量式设计验证（头脑风暴风格）

逐节展示设计，并在每节后征求批准：

1. 架构概览 → “这个方向看起来合适吗？”
2. 关键组件/模块 → “这个结构看起来合适吗？”
3. 数据流 → “这个流程看起来合适吗？”

如果用户对任何部分回答“否”，只修改该部分并重新展示。

阶段 5：生成计划文档

使用 plan-plus.template.md，根据阶段 0-4 的结果生成计划文档。

附加章节（标准 plan.template.md 中没有）：

• 用户意图探索 — 根据阶段 1 总结核心问题、目标用户和成功标准
• 备选方案探索 — 阶段 2 中比较的方法
• YAGNI 审查 — 阶段 3 中纳入、推迟和移除的项目
• 头脑风暴记录 — 阶段 1-4 中的关键决策
• 执行摘要 -- 根据阶段 1-4 的结果，自动综合 4 个视角的摘要（问题／解决方案／功能与 UX 影响／核心价值）。置于文档顶部，编号章节之前。
• 执行摘要回复 -- 必须：生成计划文档后，还要在回复中输出执行摘要表，让用户无需打开文件即可立即查看摘要。

输出路径：docs/01-plan/features/{feature}.plan.md

生成文档后，更新 PDCA 状态：

• 创建任务：[Plan] {feature}
• 更新 .bkit-memory.json：phase = "plan"

阶段 6：后续步骤

生成计划文档后：

Plan Plus completed
Document: docs/01-plan/features/{feature}.plan.md
Next step: /pdca design {feature}

核心原则

原则	来源	应用
一次只问一个问题	头脑风暴	通过 AskUserQuestion 依次提问
探索备选方案	头脑风暴	阶段 2 必须提供 2-3 种方案
严格遵循 YAGNI	头脑风暴	在阶段 3 通过 multiSelect 验证
增量验证	头脑风暴	在阶段 4 逐节审批
硬性门槛	头脑风暴	未经批准不得编写代码（整个流程中）
先了解上下文	头脑风暴	在阶段 0 自动探索

与 PDCA 的集成

Plan Plus 生成与 /pdca plan 相同的输出，并可无缝接入标准 PDCA 周期：

/plan-plus {feature}     ← Enhanced planning with brainstorming
    ↓
/pdca design {feature}   ← Standard PDCA continues
    ↓
/pdca do {feature}
    ↓
/pdca analyze {feature}
    ↓
/pdca report {feature}

使用示例

# Start brainstorming-enhanced planning
/plan-plus user-authentication

# After Plan Plus completes, continue with standard PDCA
/pdca design user-authentication
/pdca do user-authentication