feat(sdlc-analyze): 擴充為兩段式,第二段把共識變成工作包議題

第一段到共識摘要為止仍然完全不寫入;使用者點頭之後才進入第二段建立議題。
邊界條文隨之改寫成「共識摘要之前不對 Gitea 產生任何寫入」,並明列第二段
不做的事:不建相依、不掛 Milestone、不加看板、不寫人天估算——那些是後續
流程的工作,寫在這裡會讓兩顆工作包互相踩。

工作包的切法、標題規則(動詞加名詞、禁止 WP-01 這類流水編號)、待辦與驗收
的巢狀寫法(附可照抄的範例)、架構圖依性質三選一,都在這一段定下來。

邊界的斷言跟著條文一起改,因為條文換了語意;分開成兩顆 commit 的話中間那顆
會是紅的。另補一條斷言:第一段不得出現任何寫入型腳本的名字。

Closes #7

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-17 13:39:23 +08:00
co-authored by Claude Opus 5
parent f7facc84b4
commit ca363312f1
2 changed files with 94 additions and 8 deletions
+85 -6
View File
@@ -1,11 +1,12 @@
name: sdlc-analyze
description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可行性檢查,把疑點逐題問到共識並輸出摘要。
description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可行性檢查,逐題問到共識後產生工作包議題。
# sdlc-analyze
對一顆需求議題執行可行性檢查,把疑點一題一題問到雙方有共識。
對一顆需求議題執行可行性檢查,把疑點一題一題問到雙方有共識,再把共識變成一批工作包議題。
這一段到共識摘要為止,**不寫入 Gitea**。把工作包開出去是下一段的事。
分成兩段:**可行性分析**到共識摘要為止,完全不寫入 Gitea;使用者看過摘要點頭之後,
才進入**產生工作包**,那一段才會建立議題。
這份檔案是流程正本。各平台的轉接檔只是指回這裡,不要把規則抄過去。
@@ -13,7 +14,7 @@ description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可
一個需求議題編號。
## 步驟
## 第一段:可行性分析
### 1. 讀議題
@@ -66,9 +67,87 @@ node scripts/issue-extract.js --repo <owner/name> --index <編號>
摘要只印在終端,**不寫回議題、不建立任何東西**。使用者看過點頭之後,才進入下一段。
## 第二段:產生工作包
**使用者對共識摘要點頭之後才開始。** 摘要沒有經過確認就不要往下走。
### 5. 切出工作包
把需求切成幾顆工作包。一顆工作包是**開發者拿了就能動手、做完有明確結果**的單位:
它有自己的驗收標準,做完能單獨被檢視,不必等別的工作包一起才看得出成果。
切的依據是第一段問出來的共識,特別是時程清單那份暫定拆法——那本來就是這一段的草稿。
**標題格式為「{動詞}{名詞}」**,例如「建立工作包的抽取契約」、「產生圖解版總覽網頁」。
**禁止流水編號與任何無意義代號**(`WP-01`、`任務三`、`第一階段`):命名本身就要說明用途,
看標題就知道這顆在做什麼,不必點進去。
### 6. 組出每顆工作包的內容
套用 `templates/work-package-issue.md`,依序填滿九個段落:
1. **這個工作包在做什麼** — 一句話。讓人掃過標題與這一行就決定要不要點進來。
2. **描述** — 從使用者的角度說這顆做完之後什麼事變得可能,不要寫成逐層的實作清單。
3. **架構圖** — 見下方「架構圖的限制」。
4. **範圍邊界** — 明列**不做什麼**。這一段的用途是抵抗範圍蔓延,寫得越具體越有用。
5. **介面契約** — 表格,四欄:介面/產出者/消費者/形狀。讓人知道自己產出的東西誰會消費。
這顆不產出對外介面就寫一列「無」,不要留空表。
6. **待辦** — 巢狀結構:每一項待辦底下掛**它自己的**驗收標準,讓人知道這一項做到什麼程度算完成。
```
- [ ] 建立共用函式庫
- [ ] 具名 flag 解析可拒絕未知參數
- [ ] 單行 JSON 輸出格式固定
- [ ] 加上前置檢查
- [ ] 四層各自回傳可區分的錯誤碼
```
上層是待辦、縮排一層是該項的驗收,不要再往下巢狀。兩者都用 checkbox,實作時會被逐項勾選。
7. **整體驗收** — 整顆工作包做完才驗得出來的事,與個別待辦的驗收不重複。
8. **repo 列表** — 這顆會動到哪些 repo。
9. **關聯** — 至少要有一行 `需求議題:#<編號>` 指回來源。阻擋、先決與人天估算由後續流程補上。
### 7. 先試跑,再寫入
每顆工作包各寫一個暫存檔,然後逐顆:
```
node scripts/issue-create.js --repo <owner/name> --title "<標題>" --body-file <暫存檔> \
--labels "<標籤>" --dry-run
```
`--dry-run` 會印出將送出的請求、把標籤名稱換成 id,並在標題已存在時如實顯示「實跑會是
no-op」。確認無誤後拿掉該旗標再跑一次。
標籤一樣只能從 `scripts/labels-list.js` 回傳的既有標籤裡挑,**不得自行建立新標籤**。
中斷後重跑不會產生重複工作包:`issue-create` 以標題查重,發現同名議題就回傳既有那一顆
並把 `created` 設為 `false`。
### 8. 回報
列出每顆工作包的編號、標題與網址。不要把議題內容再貼一次。
## 架構圖的限制
依工作包的性質選圖:
- **`sequenceDiagram`** — 重點在「誰呼叫誰、順序為何」時用。
- **`flowchart`** — 重點在「條件分支與資料流向」時用。
- **`stateDiagram-v2`** — 重點在「狀態怎麼轉移」時用。
節點數上限 **12**,每個節點的文字上限 **8 字**。超過就拆成多張圖,或者乾脆不畫。
模板的 `{{架構圖}}` 要填入**完整的內容**,兩種形式擇一:
- 要畫:一個或多個完整的 ```mermaid 圍欄區塊。
- 不畫:一行說明為什麼不畫,**不要加圍欄**。
## 邊界
- 不對 Gitea 產生任何寫入:不建議題、不改描述、不貼標籤、不留留言。
- **共識摘要之前不對 Gitea 產生任何寫入**:不建議題、不改描述、不貼標籤、不留留言。
- 第二段只建立工作包議題。不建相依、不掛 Milestone、不加看板、不寫人天估算——那是後續流程的事。
- 不自行建立標籤、Milestone 或專案看板。
- 不修改使用者的專案檔案。查證既有功能時只讀不寫。
- 不替使用者決定他沒回答的事。問不到答案就進「仍然未決的事」。
- 不自行建立標籤、Milestone 或專案看板。
- 不關閉或刪除任何既有議題。