Spec-First

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 或 $spec-ideate
  |
  v
读取聚焦提示、repo facts、README、近期 diff、可用 graph/standards 上下文
  |
  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 结束后直接进入实现
  • Ideate 主要依赖统一 /spec:* 命令面

下一步 ​