AI 规划（Ideate）
大多数项目失败于规划，而不是执行。问题不在于缺少想法，而在于缺少质疑。团队会在没有验证假设、挑战范围或识别明显风险的情况下直接开始构建。
Almirant 中的 AI 规划不是生成工作项的工具。它是一个陪练伙伴，在你写下第一行代码之前质疑你的想法。
为什么是陪练伙伴，而不是生成器
两者的差异很关键：
- 生成器接收你的输入并产生输出。你说“我想要身份验证”，它就给你 15 项任务。
- 陪练伙伴会质疑你的输入。它会问你为什么需要身份验证、考虑过哪些替代方案、风险在哪里。
结果不只是一份工作项列表，而是经过验证的范围和受到质疑的假设。
从模糊想法到经过验证的范围
一次会话即可从模糊想法形成经过验证的范围。自动生成包含完成定义的 Epic、Story 和 Task。
规划会话
规划会话是与 AI 的多轮对话。它不是一次性提示词，而是一个迭代式对话，其中 AI 会：
- 质疑假设：质疑你认为理所当然的决定。
- 识别风险：指出规划中的盲点。
- 提出替代方案：建议你尚未考虑的方法。
- 细化范围：帮助界定纳入和排除的内容。
会话状态
每个会话会经历不同阶段：
| 阶段 | 描述 |
|---|---|
idle | 等待你开始对话 |
chatting | 与 AI 交换消息 |
streaming | 实时接收响应 |
thinking | AI 正在处理和推理（thinking 模式已启用） |
reviewing | 审查建议的工作项以接受或拒绝 |
completed | 会话已结束 |
paused | 会话已暂停，可稍后继续 |
会话历史
你的会话会自动保存，之后可以访问：
- 活动：正在进行的会话，可以继续对话。
- 已完成：已关闭且已创建工作项的会话。
- 已归档：为将来参考而保存的会话。
每个会话都会记录所用 Token（totalInputTokens、totalOutputTokens）、估算成本和持续时间，以便你优化配额使用。
创意 Seed
开始规划对话前，可以选择 Seed：Almirant 中已捕获、可作为起点的既有想法。Seed 会为会话提供初始上下文：
- 已保存的头脑风暴笔记。
- 过去会话中的想法。
- 从与利益相关者对话中捕获的需求。
工作流程
- 选择 Seed（可选）：选择既有想法以提供初始上下文。
- 开始会话：描述你想实现的目标，但要预期会被质疑。
- 与 AI 对话：回答问题、捍卫决定、重新考虑假设。
- 审查方案：范围明确后，AI 会生成结构化工作项。
- 接受或拒绝工作项：选择适用的工作项，丢弃不适用的工作项。
- 在看板中创建工作项：接受的工作项会自动创建在活动看板中。
AI 会先审查正在进行和正在 Review 的内容，避免提出已完成的工作或与当前有人正在实施的工作冲突的建议。
对话是双向的，但你的第一条消息很重要：
良好的起点
| 提示词 | 为什么有效 |
|---|---|
| “我想添加社交登录，但不确定它是否值得投入，相比魔法链接如何？” | 邀请 AI 比较替代方案 |
| “我需要提升产品列表性能，用户抱怨速度很慢” | 定义真实问题，而非假定的解决方案 |
| “我们必须从 REST 迁移到 GraphQL，团队说它更好，但我不确定” | 为质疑该决定留出空间 |
避免
| 提示词 | 问题 |
|---|---|
| “为身份验证生成任务” | 封闭了对话空间，要求直接输出 |
| “做一个用户 CRUD” | 没有要解决的问题，只有操作机制 |
| “改进整个系统” | 没有焦点，无法质疑 |
响应模式
AI 可以在不同模式下运行：
- 流式输出：生成时即可看到响应，适合快速迭代。
- 思考：AI 会在响应前逐步推理，更适合复杂问题。
你可以根据讨论内容的复杂度在模式间切换。
“你说的是 5 件事，但实际上是 3 个问题。对于仪表板优化，有三个可能原因：没有索引的查询、过度渲染或过大的载荷。你有什么线索吗？如果没有，我可以建议调查这三个方向。”
当 AI 生成工作项方案时，你会看到按类型组织的列表：
意图明确后，AI 会分析代码库：
- 哪些文件与此 Seed 相关
- 项目中如何解决类似问题（现有模式、约定）
- 鉴于当前上下文，哪种技术方案最合理
- 有哪些依赖项或风险需要考虑
每个工作项包含建议的标题、描述和层级。你可以：
- 接受单个工作项。
- 拒绝不适用的工作项。
- 如果完整提案令你满意，可全部接受。
前提条件
- 已配置且具有有效 API 密钥的AI 提供商
- 组织中有可用配额
- 至少有一个活动看板的项目
面向开发者：MCP 工具
以下工具可通过 MCP 使用：
| 工具 | 描述 | 主要参数 |
|---|---|---|
record_ai_session | 记录一个规划会话 | projectId, prompt, response, tokensUsed |
get_ai_sessions | 规划会话历史 | projectId, limit |
示例：记录 Ideate 会话
工具：record_ai_session
参数：
projectId: "uuid-del-proyecto"
prompt: "Seeds：优化仪表板，添加报告导出"
response: "方案：一个 Feature 包含 3 个 Task：数据库索引、延迟加载和导出按钮"
tokensUsed: 2840