Spec-First

Appearance

Ideate 阶段 ​

Claude Code 使用 /spec:ideate，Codex 使用 $spec-ideate。

Ideate 是主工作流的起点之一，但只在一种情况下最有价值：

  • 你还不知道现在最值得做什么

它解决的问题不是“怎么实现”，而是：

现在这份代码库里，什么值得优先探索？

Ideate 和后续阶段的分工 ​

阶段关键问题主要产物
Ideate什么值得做？docs/ideation/*.md
Brainstorm这件事具体要做成什么？docs/brainstorms/*.md
Plan应该怎么拆解和实施？docs/plans/*.md

Ideate 的输入与输出 ​

  • 输入：可选的聚焦提示
  • 输出：一份排序后的 ideation artifact

它不会直接产出：

  • requirements
  • implementation plan
  • code

什么时候应该用 ​

  • 想从真实代码库中挖出改进方向
  • 想发现技术债、DX 改进点或高价值优化机会
  • 希望先做方向选择，再进入需求澄清

什么时候不必用 ​

  • 需求已经非常明确
  • 你已经知道接下来要做哪件事
  • 当前任务本质上是一个已有 bug 修复

如果你已经知道要做什么，直接进入 Brainstorm 或 Plan 会更合适。

与代码库事实的关系 ​

Ideate 不应该是拍脑袋列灵感清单。

当前产品的定位是：

  • 先看代码库
  • 再生成方向
  • 然后把方向排序

也就是说，它应该基于仓库现实，而不是脱离实现的“产品愿景创作”。

宿主入口 ​

Claude Code：

bash
/spec:ideate

Codex：

bash
$spec-ideate

一个更准确的使用姿势 ​

text
不知道做什么
→ 先 Ideate 找方向
→ 选一个方向进入 Brainstorm
→ 再进入 Plan / Work / Review / Compound

下一步 ​

核心机制 ​

先发散后收敛 ​

Ideate 采用对抗性过滤机制保证质量：

  1. 发散 — 生成大量候选想法（约 30-40 个原始想法）
  2. 对抗过滤 — 每个被拒绝的想法必须有明确的理由
  3. 收敛 — 保留 5-7 个高质量幸存者

基于代码库生成 ​

Ideate 不是凭空想象。它先扫描实际代码库，基于真实状态生成改进建议，确保每个想法都有据可依。

等级排序 ​

最终产出按影响力排序的候选列表，每个想法附带：

  • 预期影响和实施难度
  • 与当前代码库的具体关联
  • 被采纳后的下一步指引（→ /spec:brainstorm）

何时使用 ​

场景建议
想改进项目但不确定从哪入手运行 /spec:ideate
想发现潜在的技术债或优化点运行 /spec:ideate
需要 AI 主动建议改进方向运行 /spec:ideate
已有明确想法要实施直接跳到 /spec:brainstorm

产出路径 ​

docs/ideation/
└── YYYY-MM-DD-<topic>-ideation.md

与 Brainstorm 的关系 ​

Ideate (发现值得做的事) → Brainstorm (明确做什么) → Plan (决定怎么做)

Ideate 的产出是 Brainstorm 的输入。当你从 Ideate 中选择一个方向后，可以直接启动 Brainstorm 深入探索。

下一步 ​

MIT Licensed

Copyright © 2026 Spec-First