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

New Issue

2026-09-17T03:51:18Z

jiantw83 commented

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

母議題

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

要做出什麼

讓下游指令不必重讀整份議題全文，就能取得它需要的欄位。

給定一個需求議題編號，得到一份精簡 JSON：{index, url, title, labels[], 總覽, 背景, 目標[], 非目標[], 名詞表[{term,def}], 流程圖, 驗收標準[], 影響範圍[], 未決事項[], 未處理留言數}。

這是下游（分析、實作）唯一的議題讀取管道：只讀 body 不讀留言，但要回報有幾則留言尚未被整併回描述，好讓下游知道自己是不是在用過期的描述做事。

模板解析是整條鏈的上游，解析錯則下游全錯，所以這一顆的測試分量特別重：缺段落、巢狀項目為空、checkbox 已勾、中英混排等變體都要餵進去驗證輸出契約。

驗收標準

輸出欄位與契約完全一致，缺少的段落回傳空值而非報錯
未處理留言數 反映尚未被標記為已整併的留言則數
只讀議題 body，不把留言內容納入輸出
模板變體（缺段落、巢狀項目為空、checkbox 已勾、中英混排）各有測試案例並通過
議題不存在或無讀取權時回傳可區分的錯誤碼

阻擋於

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

## 母議題 #1 — tea-sdlc：以 tea 驅動 SDLC 全流程的跨平台指令組 ## 要做出什麼讓下游指令不必重讀整份議題全文，就能取得它需要的欄位。給定一個需求議題編號，得到一份精簡 JSON：`{index, url, title, labels[], 總覽, 背景, 目標[], 非目標[], 名詞表[{term,def}], 流程圖, 驗收標準[], 影響範圍[], 未決事項[], 未處理留言數}`。這是下游（分析、實作）唯一的議題讀取管道：只讀 body 不讀留言，但要回報有幾則留言尚未被整併回描述，好讓下游知道自己是不是在用過期的描述做事。模板解析是整條鏈的上游，解析錯則下游全錯，所以這一顆的測試分量特別重：缺段落、巢狀項目為空、checkbox 已勾、中英混排等變體都要餵進去驗證輸出契約。 ## 驗收標準 - [x] 輸出欄位與契約完全一致，缺少的段落回傳空值而非報錯 - [x] `未處理留言數` 反映尚未被標記為已整併的留言則數 - [x] 只讀議題 body，不把留言內容納入輸出 - [x] 模板變體（缺段落、巢狀項目為空、checkbox 已勾、中英混排）各有測試案例並通過 - [x] 議題不存在或無讀取權時回傳可區分的錯誤碼 ## 阻擋於 - #4 — 以 sdlc-plan 把口語需求轉成結構化需求議題

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

jiantw83 referenced this issue

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

以 sdlc-analyze 逐題問到共識並輸出摘要 #6

jiantw83 referenced this issue

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

以 sdlc-sync 把留言裡的決策整併回議題描述 #15

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

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

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

#6 以 sdlc-analyze 逐題問到共識並輸出摘要

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