[工作包 A] 交付類型規則與文件抽取契約 #77

New Issue

2026-09-22T06:09:06Z

jiantw83 commented

2026-09-22 06:09:06 +00:00

這個工作包在做什麼

建立交付類型規則正本，並把需求議題的「文件」段落與抽取契約接通。

描述

新增七種交付文件的內容骨架、產出位置與逐一確認規則；模板以「文件」取代「流程圖」；issue-extract.js 改以 文件 欄位抽取，舊議題缺段落回空字串。API 契約文件只保留可重新產生的摘要契約，不寫入目標專案 repo。

架構圖

references/ 規則正本 → prompts/ 交付流程；templates/requirement-issue.md → scripts/issue-extract.js → /sdlc-analyze。

範圍邊界

只處理交付類型規則、需求議題模板與抽取契約；不改排程、不改六份正本的完整重整、不產生 HTML／SVG／preview。

介面契約

介面	產出者	消費者	形狀
交付類型規則	`references/`	`/sdlc-analyze`、`/sdlc-feat`	七種文件骨架與產出位置
需求議題模板	`templates/requirement-issue.md`	Gitea 需求議題	`## 文件` 段落
抽取 JSON	`scripts/issue-extract.js`	下游流程	`文件` 字串；缺段落為空字串

待辦

新增七種交付類型的規則正本，列出必要內容、產出位置與 ELI5 變體規則。
將需求議題模板的「流程圖」段落改為「文件」段落。
將抽取契約的 流程圖 欄位改為 文件，並保留缺段落回空字串。
更新對應測試，覆蓋新欄位、舊議題缺段落與未知段落。

整體驗收

規則正本完整涵蓋需求描述概要、WBS、流程圖、甘特圖、PERT 圖、關鍵路徑圖與 API 契約文件。
新模板抽取結果包含 文件，舊議題缺少該段落時不報錯。
API 契約文件規則明確禁止寫入目標專案 repo，且議題摘要可重產。

repo 列表

plugins/tea-sdlc

關聯

交付文件工作包；排程與流程正本工作包需使用本包的規則與契約。
估算人天：3

## 這個工作包在做什麼建立交付類型規則正本，並把需求議題的「文件」段落與抽取契約接通。 ## 描述新增七種交付文件的內容骨架、產出位置與逐一確認規則；模板以「文件」取代「流程圖」；`issue-extract.js` 改以 `文件` 欄位抽取，舊議題缺段落回空字串。API 契約文件只保留可重新產生的摘要契約，不寫入目標專案 repo。 ## 架構圖 `references/` 規則正本 → `prompts/` 交付流程；`templates/requirement-issue.md` → `scripts/issue-extract.js` → `/sdlc-analyze`。 ## 範圍邊界只處理交付類型規則、需求議題模板與抽取契約；不改排程、不改六份正本的完整重整、不產生 HTML／SVG／preview。 ## 介面契約 | 介面 | 產出者 | 消費者 | 形狀 | | --- | --- | --- | --- | | 交付類型規則 | `references/` | `/sdlc-analyze`、`/sdlc-feat` | 七種文件骨架與產出位置 | | 需求議題模板 | `templates/requirement-issue.md` | Gitea 需求議題 | `## 文件` 段落 | | 抽取 JSON | `scripts/issue-extract.js` | 下游流程 | `文件` 字串；缺段落為空字串 | ## 待辦 - [x] 新增七種交付類型的規則正本，列出必要內容、產出位置與 ELI5 變體規則。 - [x] 將需求議題模板的「流程圖」段落改為「文件」段落。 - [x] 將抽取契約的 `流程圖` 欄位改為 `文件`，並保留缺段落回空字串。 - [x] 更新對應測試，覆蓋新欄位、舊議題缺段落與未知段落。 ## 整體驗收 - [x] 規則正本完整涵蓋需求描述概要、WBS、流程圖、甘特圖、PERT 圖、關鍵路徑圖與 API 契約文件。 - [x] 新模板抽取結果包含 `文件`，舊議題缺少該段落時不報錯。 - [x] API 契約文件規則明確禁止寫入目標專案 repo，且議題摘要可重產。 ## repo 列表 - `plugins/tea-sdlc` ## 關聯交付文件工作包；排程與流程正本工作包需使用本包的規則與契約。估算人天：3

jiantw83 added the ready-for-agent label 2026-09-22 06:09:06 +00:00

jiantw83 added a new dependency 2026-09-22 06:10:24 +00:00

#75 [工作包 F] 六份流程正本重整與測試修復

jiantw83 added a new dependency 2026-09-22 06:10:24 +00:00

#73 [工作包 E] plan 文件段落

jiantw83 added a new dependency 2026-09-22 06:10:24 +00:00

#72 [工作包 D] feat 交付文件預覽分流

jiantw83 added a new dependency 2026-09-22 06:10:24 +00:00

#71 [工作包 C] analyze 交付優先流程

jiantw83 added the due date 2026-09-25

2026-09-22 06:11:04 +00:00

jiantw83 self-assigned this 2026-09-22 06:32:53 +00:00