用途
Progressive Discovery 用于在项目启动前进行系统性的前期探索。它把模糊的项目想法,通过结构化的 7 阶段工作流(Phase 0-6),转化为一份可执行的总体计划(master plan)。
主要能力
- 上下文扫描(Phase 0):扫描当前目录结构,检查已有文档(CLAUDE.md、README.md、docs/),识别技术栈(package.json、pubspec.yaml、Cargo.toml 等),检查已有 PDCA 历史,输出 context.md。
- 想法解析与执行模式选择(Phase 1):通过提问提取核心要素(问题、目标用户、价值主张、范围),呈现结构化表单并获取用户确认;同时选择执行模式(自动或手动)。
- 渐进式研究(Phase 2):对 8 大类自动进行最多 3 层深度的搜索。每类:Depth 1 做 3 次宽泛搜索,Depth 2 做 3 次深入搜索,Depth 3 做 3 次验证搜索,可提前终止。独立类别通过 Agent 工具并行执行。
- C-Suite 验证(Phase 3):从 CEO、CFO、CTO、CMO、COO、CRO、CPO、CLO、CHRO、CSO 共 10 个高管视角并行分析,视角冲突会被明确记录并请求用户决策。
- 解决方案与 YAGNI(Phase 4):从 Phase 2-3 结果提取功能候选清单,对每个功能应用 YAGNI 测试,按 MoSCoW 分类为 Must-have / Should-have / Could-have / Won't-have。
- 子计划地图(Phase 5):定义组成项目的每个领域及其范围,包括领域名称、条目清单、优先级(MVP / v1.0 / v2.0)、依赖关系。
- 总体计划生成(Phase 6):生成 00-master-plan.md 及详细章节,包含摘要、路线图(Alpha 0.1 -> Beta -> MVP -> Release 1.0)、v1.0 之后的扩展方向、章节链接、变更日志、假设登记。
使用方式
- 输入:项目目录(当前工作目录)。
- 输出:docs/00-discovery/ 目录下 30 多个研究文件 + master-plan.md,所有发现文档以用户对话语言生成。
- 执行模式:
- 自动模式:8 大类全部自动,Phase 2-6 无中断自动推进。
- 手动模式:在 Phase 2 开始前一次性为每个类别选择自动或手动;未勾选类别逐层呈现结果并等待确认,允许跳过(跳过会记录在总体计划中)。
- 并行执行:独立类别通过 Agent 工具并行,分组为 A(用户、市场、竞争)、B(解决方案、技术、内容)、C(商业模式、法律/监管)。
- 输出持久化:Phase 6 完成后,将执行元数据写入 .ww-w-ai/standards/discovery/,包括 latest.json、latest.md,并归档到 history/{timestamp}.json。JSON 字段名保持英文,latest.md 使用用户对话语言。
适用场景
- 需要把项目想法系统化、结构化为可执行计划的早期阶段。
- 需要多维度研究(用户、市场、竞品、技术、商业、法律等)的项目立项。
- 需要从多高管视角评估项目可行性的决策支持。
- 需要控制范围、避免过度设计的 MVP 规划。
限制
- 硬性门槛(HARD-GATE):Phase 6 完成前绝不写代码;即使用户要求代码也会拒绝,并告知当前 Phase 进度与剩余步骤。
- 写入权限仅限 .ww-w-ai/ 输出持久化,不修改项目源码。
- Bash 权限仅限只读的 git/系统查询,不修改文件。
- 总体计划是决策支持文档,下一步做什么由读者决定。
- 详细规格不在本技能中产出,各领域的子计划在 PDCA Plan(docs/01-plan/features/*.plan.md)中单独编写。
- 相关规则文件:docs/specs/question-principles.md、docs/specs/research.md、docs/specs/c-suite-analysis.md。
- 模板参考:templates/document-guide.md。
- 证据索引:docs/evidence/evidence-registry.md。
输出目录结构
docs/00-discovery/ ├── 00-master-plan.md ├── 01-idea.md ├── 02-research.md ├── 03-csuite-analysis.md ├── 04-solution-yagni.md ├── 05-sub-plan-map.md └── research/(context.md、各类别各深度文件最多 24 个、csuite-raw-*.md 共 10 个、search-log.md、brainstorm-notes.md)
research/ 目录为证据,永不删除。