From 6b30552ee26117090c1f4a2c984c9ddef9f1f8d8 Mon Sep 17 00:00:00 2001 From: Jeffery Date: Thu, 17 Sep 2026 06:22:28 +0000 Subject: [PATCH] =?UTF-8?q?feat(=E6=B5=81=E7=A8=8B=E6=AD=A3=E6=9C=AC):=20?= =?UTF-8?q?=E5=85=A9=E4=BB=BD=E6=AD=A3=E6=9C=AC=E5=8A=A0=E5=85=A5=E7=94=A2?= =?UTF-8?q?=E7=94=9F=E7=B8=BD=E8=A6=BD=E8=88=87=E5=AF=AB=E5=9B=9E=E7=B6=B2?= =?UTF-8?q?=E5=9D=80=E7=9A=84=E6=AD=A5=E9=A9=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 規劃版填總覽、目標、流程圖，工作包全景填空字串；分析版沿用同一份模板，額外把 工作包的相依與截止日畫成 graph TD 的全景圖。節點一樣以 12 個為上限，超過就只畫 相依鏈最長路徑上的那幾顆。 兩份都寫回同一顆需求議題的同一行，所以分析版會取代規劃版——同一顆需求議題只掛 一個總覽網址，這是預期行為，正本裡寫明免得被當成 bug。 另外交代填模板時流程圖不帶圍欄：圍欄是議題 markdown 用的，填進 HTML 會多出一段 沒有意義的字。 Closes #10 Co-Authored-By: Claude Opus 5 (1M context) --- prompts/sdlc-analyze.md | 28 +++++++++++++++++++++++++++- prompts/sdlc-plan.md | 29 ++++++++++++++++++++++++++++- 2 files changed, 55 insertions(+), 2 deletions(-) diff --git a/prompts/sdlc-analyze.md b/prompts/sdlc-analyze.md index d31b86b..7608888 100644 --- a/prompts/sdlc-analyze.md +++ b/prompts/sdlc-analyze.md @@ -176,7 +176,33 @@ node scripts/project-add.js --repo --index <編號> --project "<看 看板名稱靠掃最近 50 筆議題反查 id，反查不到就會請你直接貼專案網址（結尾即 id）。 本流程不建立 Milestone，也不建立專案。 -### 11. 回報 +### 11. 產生分析版的圖解總覽 + +用同一份 `templates/overview-artifact.html` 再產一份，但這一份要多出**工作包全景**： +把工作包之間的相依與截止日畫成一張圖，讓開發者看得出自己這一項在整體中的位置。 + +全景圖用 `graph TD`，填進 `{{工作包全景}}`，連同段落標題一起： + +``` +

工作包全景

+
graph TD + A[建立共用函式庫
09-25] --> B[建立抽取契約
09-27] +
+``` + +節點寫工作包標題與截止日，箭頭方向是「先決 → 後續」。節點一樣以 12 個為上限， +超過就只畫相依鏈最長路徑上的那幾顆，其餘在頁尾列成文字。 + +網址一樣寫回需求議題： + +``` +node scripts/issue-update.js --repo --index <需求議題編號> --overview-url <網址> +``` + +**重跑會就地更新同一行**，不會在議題上留下兩個連結。規劃階段產生的那一份會被這一份取代， +這是預期行為——同一顆需求議題只掛一個總覽網址。 + +### 12. 回報 列出每顆工作包的編號、標題、截止日與所屬 Milestone，並指出**相依鏈最長路徑**上的那幾顆 ——那條路徑決定整體交期。 diff --git a/prompts/sdlc-plan.md b/prompts/sdlc-plan.md index e67f6fa..6beed8d 100644 --- a/prompts/sdlc-plan.md +++ b/prompts/sdlc-plan.md @@ -69,7 +69,34 @@ node scripts/issue-create.js --repo --title "<標題>" --body-file 同一段需求重跑不會產生第二顆議題：`issue-create` 以標題查重，發現同名議題就回傳既有那一顆 並把 `created` 設為 `false`。 -### 6. 回報 +### 6. 產生圖解版總覽 + +套用 `templates/overview-artifact.html`，把議題的總覽、目標與流程圖填成一份可以直接投影的 +網頁。這一份是給**非技術的利害關係人**看的：他們不必讀完技術細節就知道這件事在做什麼。 + +模板的佔位對應如下，樣式不要動——版面與內容分開，改一邊不必碰另一邊： + +- `{{標題}}` 需求議題標題 +- `{{來源議題}}` 指回議題的連結 +- `{{總覽}}` 一句話總覽 +- `{{目標}}` 目標，逐條包成 `
  • ` +- `{{流程圖}}` 流程圖的 Mermaid 原始碼（**不含**圍欄，圍欄是議題 markdown 用的） +- `{{工作包全景}}` 規劃階段還沒有工作包，**填空字串**；這一段由分析階段補上 +- `{{頁尾}}` 產生時間與產生者 + +若執行環境能把 HTML 發佈成可分享的網址，就發佈；不能的話存成檔案，把路徑當成網址用。 + +拿到網址後寫回議題： + +``` +node scripts/issue-update.js --repo --index <編號> --overview-url <網址> +``` + +它把連結以固定前綴寫成總覽段落裡的一行，**重跑時就地更新同一行**，不會長出第二個連結； +議題原本的 markdown 白話總覽一字不動——網頁是補充，不是取代。連結旁會自動附上 +「此連結預設為私有，組織外無法開啟」，因為讀到的人多半會想轉寄給組織外的人。 + +### 7. 回報 把議題編號與網址告訴使用者。不要把整份議題內容再貼一次 —— 連結點進去就看得到。