feat(流程正本): 兩份正本加入產生總覽與寫回網址的步驟

規劃版填總覽、目標、流程圖,工作包全景填空字串;分析版沿用同一份模板,額外把
工作包的相依與截止日畫成 graph TD 的全景圖。節點一樣以 12 個為上限,超過就只畫
相依鏈最長路徑上的那幾顆。

兩份都寫回同一顆需求議題的同一行,所以分析版會取代規劃版——同一顆需求議題只掛
一個總覽網址,這是預期行為,正本裡寫明免得被當成 bug。

另外交代填模板時流程圖不帶圍欄:圍欄是議題 markdown 用的,填進 HTML 會多出一段
沒有意義的字。

Closes #10

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-17 14:15:59 +08:00
co-authored by Claude Opus 5
parent 5487490173
commit 8f725c9c56
2 changed files with 55 additions and 2 deletions
+27 -1
View File
@@ -176,7 +176,33 @@ node scripts/project-add.js --repo <owner/name> --index <編號> --project "<看
看板名稱靠掃最近 50 筆議題反查 id,反查不到就會請你直接貼專案網址(結尾即 id)。
本流程不建立 Milestone,也不建立專案。
### 11. 回報
### 11. 產生分析版的圖解總覽
用同一份 `templates/overview-artifact.html` 再產一份,但這一份要多出**工作包全景**:
把工作包之間的相依與截止日畫成一張圖,讓開發者看得出自己這一項在整體中的位置。
全景圖用 `graph TD`,填進 `{{工作包全景}}`,連同段落標題一起:
```
<section><h2>工作包全景</h2>
<figure><div class="mermaid">graph TD
A[建立共用函式庫<br/>09-25] --> B[建立抽取契約<br/>09-27]
</div></figure></section>
```
節點寫工作包標題與截止日,箭頭方向是「先決 → 後續」。節點一樣以 12 個為上限,
超過就只畫相依鏈最長路徑上的那幾顆,其餘在頁尾列成文字。
網址一樣寫回需求議題:
```
node scripts/issue-update.js --repo <owner/name> --index <需求議題編號> --overview-url <網址>
```
**重跑會就地更新同一行**,不會在議題上留下兩個連結。規劃階段產生的那一份會被這一份取代,
這是預期行為——同一顆需求議題只掛一個總覽網址。
### 12. 回報
列出每顆工作包的編號、標題、截止日與所屬 Milestone,並指出**相依鏈最長路徑**上的那幾顆
——那條路徑決定整體交期。