以 sdlc-plan 把口語需求轉成結構化需求議題 #4

New Issue

2026-09-17T03:51:17Z

jiantw83 commented

2026-09-17 03:51:17 +00:00

母議題

#1 — tea-sdlc：以 tea 驅動 SDLC 全流程的跨平台指令組

要做出什麼

需求提出者丟進一段口語描述（也可以是規格檔路徑、既有議題編號，或三者混用），最後在 Gitea 看到一顆結構完整的需求議題。

過程中，關鍵資訊缺漏時會被逐項詢問，而不是讓 agent 替他編造沒說過的目標。產出的議題套用固定模板：最上方一句話總覽（讓非技術的利害關係人不必讀完技術細節）、背景不超過三行、可量測的目標、非目標、領域名詞表、Mermaid 流程圖、驗收標準、影響範圍、未決事項。

標籤從 repo 既有標籤中挑選合適的貼上，不新增標籤。

重跑同一段需求不會生出第二顆議題。

此流程僅在使用者明確下指令時執行，不被模型自動觸發。

驗收標準

輸入可為自由文字、規格檔案路徑、既有議題編號，或三者混用
關鍵資訊缺漏時逐項詢問；未獲得答覆的欄位不得由 agent 自行填入內容
產出議題依序包含：一句話總覽／背景（≤3 行）／目標／非目標／領域名詞表／流程圖／驗收標準／影響範圍／未決事項
流程圖為 Mermaid flowchart，節點數 ≤12、每個節點文字 ≤8 字；超過則拆圖或不畫
標籤僅從 labels-list 回傳的既有標籤中挑選，不建立新標籤
重跑相同輸入不會產生重複議題（冪等查重）
--dry-run 輸出將發出的請求而不寫入 Gitea
流程正本為平台中立 markdown，不含任何平台專屬語法；description 前綴為「僅由 /sdlc-plan 指令叫用。」

阻擋於

#3 — 走通腳本契約：共用函式庫、四層前置檢查與 labels-list

## 母議題 #1 — tea-sdlc：以 tea 驅動 SDLC 全流程的跨平台指令組 ## 要做出什麼需求提出者丟進一段口語描述（也可以是規格檔路徑、既有議題編號，或三者混用），最後在 Gitea 看到一顆結構完整的需求議題。過程中，關鍵資訊缺漏時會被逐項詢問，而不是讓 agent 替他編造沒說過的目標。產出的議題套用固定模板：最上方一句話總覽（讓非技術的利害關係人不必讀完技術細節）、背景不超過三行、可量測的目標、非目標、領域名詞表、Mermaid 流程圖、驗收標準、影響範圍、未決事項。標籤從 repo 既有標籤中挑選合適的貼上，不新增標籤。重跑同一段需求不會生出第二顆議題。此流程僅在使用者明確下指令時執行，不被模型自動觸發。 ## 驗收標準 - [x] 輸入可為自由文字、規格檔案路徑、既有議題編號，或三者混用 - [x] 關鍵資訊缺漏時逐項詢問；未獲得答覆的欄位不得由 agent 自行填入內容 - [x] 產出議題依序包含：一句話總覽／背景（≤3 行）／目標／非目標／領域名詞表／流程圖／驗收標準／影響範圍／未決事項 - [x] 流程圖為 Mermaid `flowchart`，節點數 ≤12、每個節點文字 ≤8 字；超過則拆圖或不畫 - [x] 標籤僅從 `labels-list` 回傳的既有標籤中挑選，不建立新標籤 - [x] 重跑相同輸入不會產生重複議題（冪等查重） - [x] `--dry-run` 輸出將發出的請求而不寫入 Gitea - [x] 流程正本為平台中立 markdown，不含任何平台專屬語法；description 前綴為「僅由 /sdlc-plan 指令叫用。」 ## 阻擋於 - #3 — 走通腳本契約：共用函式庫、四層前置檢查與 labels-list

jiantw83 added the ready-for-agent label 2026-09-17 03:51:17 +00:00

jiantw83 referenced this issue

2026-09-17 03:51:18 +00:00

建立需求議題的抽取契約 #5

jiantw83 referenced this issue

2026-09-17 03:51:21 +00:00

產生圖解版總覽網頁並寫回議題 #10

jiantw83 referenced this issue

2026-09-17 03:51:24 +00:00

以 install.js 產生並移除各平台轉接檔 #17

jiantw83 added a new dependency 2026-09-17 03:51:37 +00:00

#3 走通腳本契約：共用函式庫、四層前置檢查與 labels-list