跳到主要内容

规划会话(Ideate)

Ideate 是 Almirant 的规划 Skill。你可以将积累已久的 Seeds 带入会话,AI 会把它们转化为定义清晰的任务,无论是代理还是人都能据此实现。


如何启动

在 Claude Code 中:

> /ideate

AI 启动时即可访问项目看板、待处理的 Seeds 和技术上下文,无需重新解释任何内容。

通过助手:

“为项目 X 开启一次规划会话”

会话阶段

阶段 1:分析项目状态

AI 首先会检查看板:哪些工作正在进行、哪些在审查、哪些待处理。这样可以避免提出已在进行或会与现有工作冲突的事项。

阶段 2:审查 Seeds

它会逐个读取待处理的 Seeds,并评估每个 Seed 包含多少上下文:

  • 清晰、具体的 Seeds:直接进入技术调研
  • 模糊或不明确的 Seeds:启动澄清模式

阶段 3:澄清(如有需要)

对于模糊的 Seeds,AI 不会凭空猜测。它会提出具体问题或给出替代方案:

"你提到 dashboard 加载很慢,可能有三个原因:数据库查询、同时渲染的组件数量,或下载数据的体积。你是否有任何线索?如果没有,我可以针对每个原因提出调查任务。"

它还可以发现多个 Seeds 实际上属于同一个问题:

"你有三条关于性能的 Seed。我会把它们作为同一个 Feature 处理,以避免重复工作。可以吗?"

阶段 4:技术调研

意图明确后,AI 会分析代码库:

  • 哪些文件与该 Seed 相关
  • 项目中如何解决类似问题(模式、约定)
  • 考虑上下文后,哪种技术方案最合理
  • 需要考虑哪些依赖关系或风险

阶段 5:任务提案

AI 会展示其提案:一个或多个任务,每项包含:

字段包含内容
标题清晰且可执行
描述需要做什么以及原因
完成定义具体且可验证的标准
相关文件将会修改代码库的哪些部分
技术考量方案决策、风险和已排除的替代方案

阶段 6:你的批准

你审查提案,可以:

  • 按原样批准:任务将在看板中创建
  • 要求调整:“把这个任务拆成两个” / “添加验收标准 X”
  • 拒绝某项:如果某项不合适,就将其舍弃

AI 会保留对话上下文。你可以持续迭代,直到提案符合要求。

阶段 7:在看板中创建

获得你的批准后,任务会自动在看板中创建,并关联到产生它们的 Seeds。它们会留在 Backlog 中,等待实现。


与“手动”规划相比的变化

以前使用 Ideate
从零逐个创建任务AI 提出完整结构
独自思考会影响哪些文件AI 为你分析代码库
忘记三天前某个想法的上下文Seeds 保留原始上下文
在不知情的情况下重复工作AI 发现 Seeds 之间的重叠
定义模糊的任务带有具体完成定义的任务

一次真实会话示例

> /ideate

[Ideate] 正在审查项目“发票应用”的看板...
→ 2 项任务处于 In Progress,1 项处于 Review,4 条 Seeds 待处理

[Ideate] 检测到的 Seeds:
1. “仪表板加载缓慢”(2 天前)
2. “添加报告导出”(昨天)
3. “审查管理员权限”(今天)
4. “在发票视图中添加归档按钮”(今天)

[Ideate] 第 1 和第 2 条 Seed 与主视图相关。
我会将它们作为一个可能的 Feature 一起分析。

[Ideate] 正在分析“仪表板”的代码库...
→ 已发现:DashboardPage.tsx、reportService.ts、api/reports.ts
→ `reports.created_at` 上未建立索引(性能缓慢的可能原因)
→ 尚未实现导出;发票模块中的 exportInvoices.ts 可作参考

[Ideate] 方案:

Feature:仪表板和报告改进
├── Task:在 reports.created_at 上添加索引
│ DoD:1,000 条记录时查询 < 200ms,包含迁移
│ 文件:migrations/、reportService.ts

├── Task:仪表板组件延迟加载
│ DoD:Lighthouse 中 LCP < 2.5s,无视觉回归
│ 文件:DashboardPage.tsx、componentes/

└── Task:报告导出按钮(CSV 和 PDF)
DoD:在启用筛选器时正确导出,与发票模块使用相同模式
文件:reportService.ts、api/reports.ts、componentes/ExportButton.tsx(新建)

要批准这三项任务,还是需要调整?

接下来