Ideate 详细指南

概述

Ideate 是 Spec-First 工作流中发现改进方向的阶段。

输入： 可选的聚焦提示（功能领域、关注点、约束条件） 输出： 排名列表（docs/ideation/YYYY-MM-DD-<topic>-ideation.md）

---

启动命令

/spec:ideate "可选：聚焦领域或约束"

参数类型：

参数示例	释义
DX improvements	概念聚焦
plugins/spec-first/skills/	路径聚焦
low-complexity quick wins	约束聚焦
top 3	数量控制
bugs	Issue 追踪器分析
（空）	开放式探索

---

操作步骤

步骤 1: 恢复已有文档（Phase 0.1）

如果 docs/ideation/ 中有 30 天内的相关文档：

• 读取已有文档
• 确认是继续还是重新开始
• 如继续，保留之前的想法状态和会话日志

步骤 2: 代码扫描（Phase 1）

在生成想法之前，先扫描实际代码库：

• 项目结构和文件组织
• 代码模式和潜在问题
• 依赖关系和技术栈
• 现有文档覆盖度

扫描结果作为想法生成的事实基础，避免脱离实际的建议。

步骤 3: 发散生成（Phase 2）

基于扫描结果生成大量候选想法：

• 每个子代理生成约 7-8 个想法
• 交叉多个代理提高多样性
• 覆盖不同维度（DX、性能、安全、可维护性等）

步骤 4: 对抗过滤（Phase 3）

对候选列表执行严格过滤：

• 每个被拒绝的想法必须附带明确理由
• 保留标准：有据可依、可执行、有实质影响
• 去重：合并相似想法

步骤 5: 等级排序（Phase 4）

对幸存者排序并生成最终文档：

字段	说明
影响力	高/中/低
难度	高/中/低
代码关联	具体文件或模块
下一步	通常指向 /spec:brainstorm

---

过滤后的 5 种维护结果

对于 docs/ideation/ 中已有文档的处理：

结果	含义	动作
Keep	仍然准确有用	不编辑，报告已审查
Update	核心正确但细节偏移	原地更新
Consolidate	多个文档重叠	合并到规范文档
Replace	有更好的替代	创建替代文档
Delete	不再适用	删除（git 保留历史）

---

与 Brainstorm 的衔接

Ideate 的最终输出指向 Brainstorm：

Ideate 产出排名列表
    ↓ 用户选择一个方向
/spec:brainstorm "选定的想法"
    ↓ 深入探索
docs/brainstorms/*.md

关键原则： Ideate 发现方向，Brainstorm 定义细节，不直接跳到实现。

---

最佳实践

• ✅ 让 AI 先扫描 — 代码库扫描确保建议有据可依
• ✅ 接受被过滤 — 被拒绝的想法都有明确理由
• ✅ 关注幸存者质量 — 5-7 个高质量想法优于 50 个泛泛建议
• ✅ 聚焦优先 — 提供聚焦提示可以获得更精准的建议
• ✅ 衔接 Brainstorm — 选定方向后立即启动 Brainstorm

---

常见错误

• ❌ 跳过代码扫描 → ✅ 扫描确保建议基于真实状态
• ❌ 不舍得放弃想法 → ✅ 过滤是质量保证，不是损失
• ❌ 直接实现 → ✅ Ideate → Brainstorm → Plan，循序渐进
• ❌ 一次处理太多 → ✅ 聚焦一个方向，深入探索

---

判定标准

完成 Ideate 后，检查以下条件：

• [ ] 代码库已扫描
• [ ] 候选想法已生成
• [ ] 对抗过滤已完成（每个拒绝有理由）
• [ ] 幸存者已排序
• [ ] Ideation 文档已生成

满足后，选择一个方向启动 /spec:brainstorm。

---

下一步

• Brainstorm 详细指南 - 将选定想法转化为需求
• Ideate 阶段概念 - 理解 Ideate 在工作流中的定位