SuperAPI AI 工具集

discovery

办公与效率

查看项目

更新于 10-16 07:30

技能介绍

用途

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/ 目录为证据,永不删除。