Ideate 详细指南 ​

当前入口是 spec-ideate。Claude Code /spec:ideate 与 Codex $spec-ideate 是兼容别名；契约见 spec-ideate。

Ideate 的目标不是写需求，也不是生成计划，而是基于当前代码库提出 值得继续投入的方向。

输入与输出 ​

  • 输入：可选聚焦提示
  • 输出：docs/ideation/*.md

这一步结束后，你拿到的应该是“方向候选及排序”，而不是需求文档或实施方案。

什么时候运行 ​

适合：

  • 你不确定下一步最值得做什么
  • 想在真实代码基础上找高价值改进点
  • 想让 AI 帮你先做一轮方向发散与筛选

不适合：

  • 需求已经明确
  • 已经有 brainstorm 文档
  • 你现在只是要执行既定计划

使用方式 ​

Claude Code：

bash
spec-ideate
spec-ideate "DX improvements"

Codex：

bash
spec-ideate
spec-ideate "DX improvements"

执行逻辑图 ​

text
用户运行 spec-ideate
  |
  v
读取聚焦提示、repo facts、README、近期 diff、可用 graph/project guidance 上下文
  |
  v
扫描问题空间和改进机会
  |
  v
生成候选方向
  |
  v
按价值、风险、复杂度、证据强度去重和排序
  |
  v
输出 docs/ideation/*.md
  |
  v
用户选定方向后进入 spec-brainstorm

理想执行顺序 ​

  1. 先扫描代码库
  2. 生成候选方向
  3. 去重、过滤、排序
  4. 选定一个方向
  5. 进入 Brainstorm

你可以把它理解为“方向发现层”，而不是主交付链中的需求定义层。

结果如何使用 ​

Ideate 的结果最适合这样消费：

text
Ideate
→ 选定一个方向
→ Brainstorm
→ Plan

它不应直接跳到 Work。

使用边界 ​

  • Ideate 不是自由 brainstorming；候选方向必须带证据、价值判断和拒绝理由。
  • Ideate 产物不直接交给 work；先选一个方向进入 brainstorm，把需求和验收标准收敛清楚。
  • 当前产品面统一写 spec-ideate；只在兼容别名说明中提到 Claude Code /spec:ideate 或 Codex $spec-ideate。

下一步 ​