plan

name	plan
source	../../../../skills/plan/SKILL.md
source_version	2.0.0
translation_version	2.0.0
last_synced	"2026-07-16T00:00:00.000Z"
source_hash	375b1ddb3613
scope	universal
description	[UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。 Use when: converting specifications into executable task plans for /orchestrate. Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
argument-hint	[spec-file.md | openspec-dir/ | "需求描述文本" | (交互模式)]

/plan — 从 Spec 自动生成 plan.json

语言: English | 简体中文

用法

/plan <spec-file.md>              # Spec 模式（自有格式 / SpecKit）
/plan <openspec-change-dir/>      # OpenSpec 模式
/plan "需求描述文本"               # 需求模式
/plan                             # 交互模式（自动检测）

---

执行流程

Step 1：输入识别与格式检测

根据参数类型判断使用模式：

参数是 .md 文件：

1. 读取文件内容
2. 检测格式：
   • 含 ## Requirements 且 ## Technical Design → 自有格式（SPEC-NNN-*.md）
   • 含 ## Summary 且 ## Detailed Design → SpecKit 格式
   • 其他 .md → 尝试解析为通用 Spec（按自有格式处理，缺少的字段由 AI 补充）

参数是目录：

1. 检查是否含 proposal.md + tasks.md → OpenSpec 格式
2. 否则报错：「此目录不符合 OpenSpec 结构」

参数是字符串描述（非文件路径）： → 需求模式

无参数： → 交互模式

1. 检测 openspec/ 目录存在？ → 列出 changes 让用户选择
2. 检测 specs/*.md 存在？ → 列出可用 Spec 让用户选择
3. 都没有 → 进入需求模式问答

---

Step 2：项目 Context 收集

读取目标项目的关键信息：

1. CLAUDE.md / AGENTS.md — 语言、框架、测试工具、开发规范
2. package.json / pyproject.toml — 可用 scripts（build, test, lint）

从 Context 推断：

• 主要语言（TypeScript / Python / 其他）
• 默认 verify_command（如 pnpm build && pnpm test、pytest -x）
• 默认 lint_command（如 pnpm lint、ruff check .）

---

Step 3：Spec 解析

依检测到的格式，解析 Spec 内容：

自有格式（SPEC-NNN-*.md）

提取以下区段：

• Summary / Motivation → 理解背景与需求动机
• Requirements (REQ-NNN) → 功能需求列表
• Acceptance Criteria (AC-N) → Given/When/Then 验收条件
• Technical Design → Phase 分层、每个 Phase 的实现项目
• Test Plan → 测试清单