name: sdlc-plan
description: 僅由 /sdlc-plan 指令叫用。把一段口語需求轉成結構化的需求議題，寫入 Gitea。

# sdlc-plan

把自由文字、規格檔或既有議題整理成需求議題。

## 步驟

### 1. 列出九段落依據與缺漏〔可委派〕

讀齊輸入，列出總覽、背景、目標、非目標、領域名詞表、文件、驗收標準、影響範圍與未決事項中已有依據與缺漏。這一步只產出可核對的清單；你的環境若能把工作交給子代理，就交出去，只把清單帶回來；不能就自己做。

### 2. 一次問一題補齊缺漏

一次問一題補齊缺漏；未獲回答的內容放入「未決事項」，不得自行編造。

### 3. 填入需求議題模板

套用 `templates/requirement-issue.md`，填入總覽、背景、目標、非目標、領域名詞表、文件、驗收標準、影響範圍與未決事項；全程使用繁體中文。

### 4. 取得既有標籤

用 `scripts/labels-list.js` 取得既有標籤，只能選既有標籤。

### 5. 試跑並建立議題

寫入前先執行：

```
node scripts/issue-create.js --repo <owner/name> --title "<標題>" --body-file <暫存檔> --labels "<標籤>" --dry-run
```

確認內容後移除 `--dry-run` 實跑。重跑以標題查重，不建立重複議題。

## 文件限制

文件段落只填以下其中一種：

- `待 /sdlc-analyze 產生`。
- 抽象節點與邊的文字描述，不寫具體圖形語法。

plan 階段禁止產生 HTML、SVG、manifest、截圖、附件或任何平台 preview。

## 邊界

- 不修改使用者專案檔案。
- 不建立標籤、Milestone 或專案看板。
- 不關閉或刪除既有議題。
- 不產生任何預覽或 artifact。
- 回報議題編號與網址，不重貼全文。