planlisted

# /plan — 從 Spec 自動生成 plan.json > **語言**: [English](../../../../skills/plan/SKILL.md) | 繁體中文 ## 用法 ``` /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** → 測試清單 - **Risks** → 風險評估 #### OpenSpec（change 目錄） 讀取以下檔案： - `propos