改善 /sdlc-plan 的引導式需求補全規則 #86

New Issue

2026-09-22T10:24:17Z

jiantw83 commented

2026-09-22 10:24:17 +00:00

這個工作包在做什麼

改善 /sdlc-plan 的引導式需求補全規則，讓產品／業務使用者在建立需求議題前補齊可理解、可驗收的內容。

描述

技術版

目前 /sdlc-plan 只檢查九個段落是否有內容，沒有判斷角色、情境、行為與可觀察結果是否完整。本工作包更新 prompts/sdlc-plan.md，必要時新增 references/requirements-discovery.md，使 coding agent 能：

一次只問一個需求缺口。
說明目前理解、缺少內容與提問原因。
提供建議選項或範例，同時允許使用者自由回答。
確認主要成功情境，以及適用的失敗或邊界情境。
將「尚未決定」或未回答視為未完成；只有使用者明確確認「不適用」並說明原因，才算完成。
所有缺口補完前不建立需求議題。

已確認的交付文件：

需求描述概要：技術版與 ELI5 版，放在本工作包描述。
WBS：放在本工作包的待辦、整體驗收與關聯段落。
流程圖：抽象節點與邊的文字版及 ELI5 版，放在架構圖或描述段落。
甘特圖：不交付；單一工作包且無日期承諾。
PERT：O = 1 人天、M = 2 人天、P = 4 人天；保留於描述與排程摘要。
關鍵路徑圖：不交付；單一工作包且無相依分支。
API 契約文件：不交付；不新增或修改 API、事件或 CLI 介面。

ELI5 版

讓提出需求的人不必自己猜要寫哪些細節。系統會一次問一個問題，給出例子和建議，直到大家都清楚誰要做什麼、什麼情況下會發生什麼結果，才建立需求單。

架構圖

抽象流程：提出需求 → 讀取九段落 → 判斷內容缺口 → 顯示目前理解、缺口、原因與建議答案 → 一次詢問一題 → 更新工作稿 → 檢查角色／情境／行為／可觀察結果 → 檢查成功及適用的失敗／邊界情境 → 缺口未完成則繼續提問 → 全部完成後建立需求議題。

停止分支：使用者未回答或回答「尚未決定」→ 保留待回答問題 → 不建立議題。

不適用分支：使用者確認「不適用」並說明原因 → 標記該項已處理 → 繼續檢查其他缺口。

ELI5：使用者先說明想做什麼。系統會檢查還缺哪些重要資訊，一次問一個問題並提供例子。資訊補齊後才建立需求單；如果使用者沒有決定，就先停下來，不建立需求單。

範圍邊界

包含：

prompts/sdlc-plan.md 的需求內容品質判定、逐題引導與建立門檻。
必要時新增 references/requirements-discovery.md，集中需求補全規則。
驗證 prompt 輸出與既有流程契約未變。

不包含：

templates/requirement-issue.md 段落結構變更。
scripts/issue-extract.js 或其 JSON 輸出契約變更。
/sdlc-analyze 的可行性分析責任變更。
新增 Gitea API、事件、CLI 參數或資料層變更。
HTML、SVG、manifest、截圖、附件或平台 preview。

介面契約

介面	產出者	消費者	形狀
`/sdlc-plan` 流程正本	`prompts/sdlc-plan.md`	`tea-sdlc prompt` 與平台轉接檔	平台中立 Markdown 純文字
需求補全規則	`references/requirements-discovery.md`（若新增）	`/sdlc-plan`	Markdown 規則文件
prompt 輸出	`tea-sdlc prompt --name sdlc-plan`	各平台助理	原樣多行文字，不新增 JSON 欄位或 CLI 參數

待辦

更新 prompts/sdlc-plan.md，加入內容品質判定、角色／情境／行為／可觀察結果檢查，以及逐題引導格式。
必要時新增 references/requirements-discovery.md，集中可理解、可驗收、成功／失敗／邊界情境與不適用判準。
確認「尚未決定」或未回答會停止建立議題；明確「不適用」需附理由才能繼續。
執行 tea-sdlc prompt --name sdlc-plan，確認流程正本輸出包含新規則且仍為平台中立 Markdown。
執行現有 prompt／安裝驗證測試，確認轉接檔與既有 CLI 契約未變。

整體驗收

/sdlc-plan 不再只以段落非空判定完成，會要求角色、情境、行為與可觀察結果。
每次只提出一個問題，並說明目前理解、缺口、原因，提供建議選項或範例，且允許自由回答。
主要成功情境已確認；適用時失敗或邊界情境也已確認。
未回答或「尚未決定」不會建立需求議題。
「不適用」只有在使用者明確確認並提供理由後才算完成。
所有缺口補完後仍產出既有需求議題格式，不修改模板或抽取契約。
tea-sdlc prompt --name sdlc-plan 可正常輸出更新後的正本，且平台轉接檔仍能使用。
不新增 API、資料表、遷移、外部服務或目標專案檔案。

repo 列表

plugins/tea-sdlc

關聯

需求議題：#85 讓 /sdlc-plan 以引導式訪談補全可驗收需求
先決工作包：無
PERT：O = 1 人天；M = 2 人天；P = 4 人天
估算人天：2

## 這個工作包在做什麼改善 `/sdlc-plan` 的引導式需求補全規則，讓產品／業務使用者在建立需求議題前補齊可理解、可驗收的內容。 ## 描述 ### 技術版目前 `/sdlc-plan` 只檢查九個段落是否有內容，沒有判斷角色、情境、行為與可觀察結果是否完整。本工作包更新 `prompts/sdlc-plan.md`，必要時新增 `references/requirements-discovery.md`，使 coding agent 能： - 一次只問一個需求缺口。 - 說明目前理解、缺少內容與提問原因。 - 提供建議選項或範例，同時允許使用者自由回答。 - 確認主要成功情境，以及適用的失敗或邊界情境。 - 將「尚未決定」或未回答視為未完成；只有使用者明確確認「不適用」並說明原因，才算完成。 - 所有缺口補完前不建立需求議題。已確認的交付文件： - 需求描述概要：技術版與 ELI5 版，放在本工作包描述。 - WBS：放在本工作包的待辦、整體驗收與關聯段落。 - 流程圖：抽象節點與邊的文字版及 ELI5 版，放在架構圖或描述段落。 - 甘特圖：不交付；單一工作包且無日期承諾。 - PERT：O = 1 人天、M = 2 人天、P = 4 人天；保留於描述與排程摘要。 - 關鍵路徑圖：不交付；單一工作包且無相依分支。 - API 契約文件：不交付；不新增或修改 API、事件或 CLI 介面。 ### ELI5 版讓提出需求的人不必自己猜要寫哪些細節。系統會一次問一個問題，給出例子和建議，直到大家都清楚誰要做什麼、什麼情況下會發生什麼結果，才建立需求單。 ## 架構圖抽象流程：提出需求 → 讀取九段落 → 判斷內容缺口 → 顯示目前理解、缺口、原因與建議答案 → 一次詢問一題 → 更新工作稿 → 檢查角色／情境／行為／可觀察結果 → 檢查成功及適用的失敗／邊界情境 → 缺口未完成則繼續提問 → 全部完成後建立需求議題。停止分支：使用者未回答或回答「尚未決定」→ 保留待回答問題 → 不建立議題。不適用分支：使用者確認「不適用」並說明原因 → 標記該項已處理 → 繼續檢查其他缺口。 ELI5：使用者先說明想做什麼。系統會檢查還缺哪些重要資訊，一次問一個問題並提供例子。資訊補齊後才建立需求單；如果使用者沒有決定，就先停下來，不建立需求單。 ## 範圍邊界包含： - `prompts/sdlc-plan.md` 的需求內容品質判定、逐題引導與建立門檻。 - 必要時新增 `references/requirements-discovery.md`，集中需求補全規則。 - 驗證 prompt 輸出與既有流程契約未變。不包含： - `templates/requirement-issue.md` 段落結構變更。 - `scripts/issue-extract.js` 或其 JSON 輸出契約變更。 - `/sdlc-analyze` 的可行性分析責任變更。 - 新增 Gitea API、事件、CLI 參數或資料層變更。 - HTML、SVG、manifest、截圖、附件或平台 preview。 ## 介面契約 | 介面 | 產出者 | 消費者 | 形狀 | | --- | --- | --- | --- | | `/sdlc-plan` 流程正本 | `prompts/sdlc-plan.md` | `tea-sdlc prompt` 與平台轉接檔 | 平台中立 Markdown 純文字 | | 需求補全規則 | `references/requirements-discovery.md`（若新增） | `/sdlc-plan` | Markdown 規則文件 | | prompt 輸出 | `tea-sdlc prompt --name sdlc-plan` | 各平台助理 | 原樣多行文字，不新增 JSON 欄位或 CLI 參數 | ## 待辦 - [x] 更新 `prompts/sdlc-plan.md`，加入內容品質判定、角色／情境／行為／可觀察結果檢查，以及逐題引導格式。 - [x] 必要時新增 `references/requirements-discovery.md`，集中可理解、可驗收、成功／失敗／邊界情境與不適用判準。 - [x] 確認「尚未決定」或未回答會停止建立議題；明確「不適用」需附理由才能繼續。 - [x] 執行 `tea-sdlc prompt --name sdlc-plan`，確認流程正本輸出包含新規則且仍為平台中立 Markdown。 - [x] 執行現有 prompt／安裝驗證測試，確認轉接檔與既有 CLI 契約未變。 ## 整體驗收 - [x] `/sdlc-plan` 不再只以段落非空判定完成，會要求角色、情境、行為與可觀察結果。 - [x] 每次只提出一個問題，並說明目前理解、缺口、原因，提供建議選項或範例，且允許自由回答。 - [x] 主要成功情境已確認；適用時失敗或邊界情境也已確認。 - [x] 未回答或「尚未決定」不會建立需求議題。 - [x] 「不適用」只有在使用者明確確認並提供理由後才算完成。 - [x] 所有缺口補完後仍產出既有需求議題格式，不修改模板或抽取契約。 - [x] `tea-sdlc prompt --name sdlc-plan` 可正常輸出更新後的正本，且平台轉接檔仍能使用。 - [x] 不新增 API、資料表、遷移、外部服務或目標專案檔案。 ## repo 列表 - `plugins/tea-sdlc` ## 關聯 - 需求議題：#85 讓 `/sdlc-plan` 以引導式訪談補全可驗收需求 - 先決工作包：無 - PERT：O = 1 人天；M = 2 人天；P = 4 人天估算人天：2

jiantw83 added the ready-for-agent label 2026-09-22 10:24:17 +00:00

jiantw83 added the due date 2026-09-25

2026-09-22 10:27:08 +00:00

jiantw83 referenced this issue

2026-09-23 00:54:40 +00:00

feat/guided-requirement-completion/main #87

Sign in to join this conversation.

1 Participants

Notifications

Due Date

2026-09-25

Dependencies

No dependencies set.

Reference: plugins/tea-sdlc#86