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:
+27
-1
@@ -176,7 +176,33 @@ node scripts/project-add.js --repo <owner/name> --index <編號> --project "<看
|
|||||||
看板名稱靠掃最近 50 筆議題反查 id,反查不到就會請你直接貼專案網址(結尾即 id)。
|
看板名稱靠掃最近 50 筆議題反查 id,反查不到就會請你直接貼專案網址(結尾即 id)。
|
||||||
本流程不建立 Milestone,也不建立專案。
|
本流程不建立 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,並指出**相依鏈最長路徑**上的那幾顆
|
列出每顆工作包的編號、標題、截止日與所屬 Milestone,並指出**相依鏈最長路徑**上的那幾顆
|
||||||
——那條路徑決定整體交期。
|
——那條路徑決定整體交期。
|
||||||
|
|||||||
+28
-1
@@ -69,7 +69,34 @@ node scripts/issue-create.js --repo <owner/name> --title "<標題>" --body-file
|
|||||||
同一段需求重跑不會產生第二顆議題:`issue-create` 以標題查重,發現同名議題就回傳既有那一顆
|
同一段需求重跑不會產生第二顆議題:`issue-create` 以標題查重,發現同名議題就回傳既有那一顆
|
||||||
並把 `created` 設為 `false`。
|
並把 `created` 設為 `false`。
|
||||||
|
|
||||||
### 6. 回報
|
### 6. 產生圖解版總覽
|
||||||
|
|
||||||
|
套用 `templates/overview-artifact.html`,把議題的總覽、目標與流程圖填成一份可以直接投影的
|
||||||
|
網頁。這一份是給**非技術的利害關係人**看的:他們不必讀完技術細節就知道這件事在做什麼。
|
||||||
|
|
||||||
|
模板的佔位對應如下,樣式不要動——版面與內容分開,改一邊不必碰另一邊:
|
||||||
|
|
||||||
|
- `{{標題}}` 需求議題標題
|
||||||
|
- `{{來源議題}}` 指回議題的連結
|
||||||
|
- `{{總覽}}` 一句話總覽
|
||||||
|
- `{{目標}}` 目標,逐條包成 `<li>`
|
||||||
|
- `{{流程圖}}` 流程圖的 Mermaid 原始碼(**不含**圍欄,圍欄是議題 markdown 用的)
|
||||||
|
- `{{工作包全景}}` 規劃階段還沒有工作包,**填空字串**;這一段由分析階段補上
|
||||||
|
- `{{頁尾}}` 產生時間與產生者
|
||||||
|
|
||||||
|
若執行環境能把 HTML 發佈成可分享的網址,就發佈;不能的話存成檔案,把路徑當成網址用。
|
||||||
|
|
||||||
|
拿到網址後寫回議題:
|
||||||
|
|
||||||
|
```
|
||||||
|
node scripts/issue-update.js --repo <owner/name> --index <編號> --overview-url <網址>
|
||||||
|
```
|
||||||
|
|
||||||
|
它把連結以固定前綴寫成總覽段落裡的一行,**重跑時就地更新同一行**,不會長出第二個連結;
|
||||||
|
議題原本的 markdown 白話總覽一字不動——網頁是補充,不是取代。連結旁會自動附上
|
||||||
|
「此連結預設為私有,組織外無法開啟」,因為讀到的人多半會想轉寄給組織外的人。
|
||||||
|
|
||||||
|
### 7. 回報
|
||||||
|
|
||||||
把議題編號與網址告訴使用者。不要把整份議題內容再貼一次 —— 連結點進去就看得到。
|
把議題編號與網址告訴使用者。不要把整份議題內容再貼一次 —— 連結點進去就看得到。
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user