plan

用途

plan 用于为任务、技术探索（spike）和缺陷（bug）创建基于阶段的 PLAN.md 文件。它通常在通过 /issue 创建 issue 之后使用，把工作拆解为多个阶段。

主要能力

根据 issue 类型生成不同的计划结构：
- 任务（TASK.md）：带检查点的顺序阶段，生成 PLAN.md
- 缺陷（BUG.md）：调查 → 修复阶段，生成 PLAN.md
- 技术探索（SPIKE.md）：按每种方案生成探索阶段，生成 PLAN-1.md、PLAN-2.md 等
自动识别项目，也可通过 --project 显式指定项目
加载上下文：读取 issue 文件、specs、ADR、研究资料
跨项目模式搜索：在其他项目中查找相似实现并写入计划
库文档验证：当任务涉及安装/配置外部库或 SDK、框架集成、第三方服务时，通过 Context7 解析库 ID、获取当前文档，并搜索近期最佳实践
可选同行评审：通过 --second-opinion 调用 Gemini CLI 评审计划

使用方式

/plan 001                    # 为 issue 001 创建计划（自动识别项目）
/plan 001 --project coordinatr  # 显式指定项目
/plan SPIKE-003              # 为 spike 创建探索计划
/plan 003 --second-opinion   # 在最终确定前获取 Gemini CLI 的同行评审

执行流程（任务/缺陷）：

加载上下文：读取 ideas/[project]/issues/###-*/TASK.md（或 BUG.md）；若存在 implements: 字段，读取 spaces/[project]/docs/specs/*.md；Glob spaces/[project]/docs/adrs/ADR-*.md；Glob resources/research/*.md。
跨项目模式搜索：Grep: spaces/*/src/ 查找相关模式，并在计划的“Related Implementations”部分列出。
库文档验证（涉及集成时强制）：
- mcp__context7__resolve-library-id: {libraryName}
- mcp__context7__query-docs: {context7CompatibleLibraryID}
- WebSearch: "{library} {framework} integration 2026"
生成计划：拆分为逻辑阶段，每阶段有明确交付物，阶段间设检查点，添加“Done When”标准。
写入 PLAN.md，包含阶段、预估工作量、依赖；如适用包含“Library Documentation Validation”部分；如请求则包含“Second Opinion Analysis”部分。
提交建议：询问“Commit PLAN.md to ideas repo? (yes/no)”。

执行流程（spike）：

加载上下文：读取 SPIKE.md（问题、成功标准、时间盒）。
收集方案：询问“How many approaches to explore?”得到 N；对每个方案询问“Describe approach N?”。
为每个方案生成 PLAN-N.md。
询问是否提交所有计划文件。

适用场景

在创建 issue 后，需要把工作拆解为可执行阶段时
需要为缺陷制定调查与修复计划时
需要为技术探索制定多方案探索计划时
涉及外部库或框架集成，需要基于最新文档验证方案时
希望获得同行评审（Gemini CLI）时

限制

使用 --second-opinion 需要已安装且可用的 Gemini CLI；若 Gemini 不可用，则优雅降级为仅 Claude 计划。
库文档验证仅在任务涉及安装/配置外部库或 SDK、框架集成、第三方服务时强制进行。
其他未在资料中说明的限制暂未提供。

工作流

/spec → /issue → /plan {ID} → (work phases) → /complete {ID}
                    ↓
          Load spec section from implements: field

生成文件位置：

任务/缺陷：ideas/{project}/issues/###-*/PLAN.md
技术探索：ideas/{project}/issues/###-*/PLAN-1.md、PLAN-2.md 等

技能介绍

用途

主要能力

使用方式

适用场景

限制

工作流