feat/delivery-document-contract/main #80

2026-09-22T06:45:20Z

jiantw83 commented

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

摘要

建立七種交付文件的規則正本，並把需求模板與 issue-extract 的欄位切換為「文件」。

需求議題

#1

工作包議題

#77

變更內容

新增 references/delivery-types.md，定義需求描述概要、WBS、流程圖、甘特圖、PERT 圖、關鍵路徑圖與 API 契約文件的骨架、產出位置、ELI5 變體及逐一確認規則。
將 templates/requirement-issue.md 的 ## 流程圖 改為 ## 文件。
將 scripts/issue-extract.js 的抽取欄位由 流程圖 改為 文件，缺段落仍回傳空字串。
更新抽取測試，覆蓋新欄位、舊議題缺段落與未知段落；新增規則正本與模板資產測試。

設計重點

文件規則集中在 references/，不把交付類型知識散落到流程正本或目標專案。
API 契約只交付預覽或使用者確認的位置，禁止寫入目標專案 repo；摘要保留來源以便重新產生。
保留既有 fenced content 原樣抽取行為，僅變更需求議題段落名稱與輸出欄位。

解決的問題

需求議題模板與抽取契約原本使用「流程圖」，無法表達七種交付文件，也沒有共用的內容與 ELI5 規則；本變更使下游能穩定取得 文件 欄位。

影響的功能

/sdlc-plan 使用的需求議題模板欄位。
scripts/issue-extract.js 及其下游 /sdlc-analyze 的需求抽取契約。
/sdlc-feat 可讀取的交付文件規則正本。

測試結果

node --test test/issue-extract.test.js test/delivery-types-assets.test.js：33 passed。
npm test：544 passed、1 failed；既有 test/bin-entry.test.js 依賴 npm pack --dry-run --json 回傳陣列，但目前 npm 回傳物件，失敗與本次變更無關。
git diff --check：通過。

## 摘要建立七種交付文件的規則正本，並把需求模板與 issue-extract 的欄位切換為「文件」。 ## 需求議題 https://gitea.jsc.idv.tw/plugins/tea-sdlc/issues/1 ## 工作包議題 https://gitea.jsc.idv.tw/plugins/tea-sdlc/issues/77 ## 變更內容 - 新增 `references/delivery-types.md`，定義需求描述概要、WBS、流程圖、甘特圖、PERT 圖、關鍵路徑圖與 API 契約文件的骨架、產出位置、ELI5 變體及逐一確認規則。 - 將 `templates/requirement-issue.md` 的 `## 流程圖` 改為 `## 文件`。 - 將 `scripts/issue-extract.js` 的抽取欄位由 `流程圖` 改為 `文件`，缺段落仍回傳空字串。 - 更新抽取測試，覆蓋新欄位、舊議題缺段落與未知段落；新增規則正本與模板資產測試。 ## 設計重點 - 文件規則集中在 `references/`，不把交付類型知識散落到流程正本或目標專案。 - API 契約只交付預覽或使用者確認的位置，禁止寫入目標專案 repo；摘要保留來源以便重新產生。 - 保留既有 fenced content 原樣抽取行為，僅變更需求議題段落名稱與輸出欄位。 ## 解決的問題需求議題模板與抽取契約原本使用「流程圖」，無法表達七種交付文件，也沒有共用的內容與 ELI5 規則；本變更使下游能穩定取得 `文件` 欄位。 ## 影響的功能 - `/sdlc-plan` 使用的需求議題模板欄位。 - `scripts/issue-extract.js` 及其下游 `/sdlc-analyze` 的需求抽取契約。 - `/sdlc-feat` 可讀取的交付文件規則正本。 ## 測試結果 - `node --test test/issue-extract.test.js test/delivery-types-assets.test.js`：33 passed。 - `npm test`：544 passed、1 failed；既有 `test/bin-entry.test.js` 依賴 `npm pack --dry-run --json` 回傳陣列，但目前 npm 回傳物件，失敗與本次變更無關。 - `git diff --check`：通過。

jiantw83 added 2 commits 2026-09-22 06:45:20 +00:00

feat(交付文件): 接通文件交付規則與抽取契約 dd3a522b38

建立七種交付文件的規則正本，並讓需求模板與 issue-extract 使用文件欄位；測試涵蓋新欄位、缺段落與未知段落。

test(交付文件): 接通文件交付規則與抽取契約 0291002831

建立七種交付文件的規則正本，並讓需求模板與 issue-extract 使用文件欄位；測試涵蓋新欄位、缺段落與未知段落。

admin approved these changes 2026-09-22 06:54:41 +00:00

admin merged commit e0a26b81e5 into master

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

admin deleted branch feat/delivery-document-contract/main

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

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/tea-sdlc#80