feat(workflow-assets): 整合流程正本與委派規則

以能力描述補齊可委派步驟,讓流程正本、委派規則、AGENTS、README 與 ADR 保持同一份繁體中文與 UTF-8 契約。
This commit is contained in:
2026-09-22 15:31:36 +08:00
parent 52b5f08e7e
commit c56f3271b5
4 changed files with 39 additions and 12 deletions
+10 -1
View File
@@ -9,6 +9,8 @@ description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可
## 第一段:可行性分析
### 1. 對四份清單列出疑點〔可委派〕
依序讀取並逐條對照:
1. `references/feasibility-architecture.md`
@@ -16,6 +18,10 @@ description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可
3. `references/feasibility-data.md`
4. `references/feasibility-schedule.md`
只產出可核對的疑點清單,不替使用者做決策;你的環境若能把工作交給子代理,就交出去,只把清單帶回來;不能就自己做。
### 2. 逐題確認可行性共識
能從程式碼查證的事項自行查證;只有需要使用者決策的事項才提問。架構、邏輯、資料、時程四類依序完成,每次只問一題,每題提供建議與理由,以及手動輸入的方式。最後輸出共識摘要、變更假設、未決事項與人天估算;摘要只印終端,不寫入 Gitea。
### 交付文件判斷
@@ -49,7 +55,10 @@ description: 僅由 /sdlc-analyze 指令叫用。對一顆需求議題執行可
## 第三段:排程
所有工作包建立且相依關係確認後,以 `startDate`、`days` 與 `depends` 組成計畫檔,執行 `scripts/schedule.js` 計算截止日;依序用 `issue-link.js`、`issue-update.js` 與 `project-add.js` 補上既有相依、Milestone、看板、截止日與人天估算。各腳本先 dry-run,再實跑。日期與人天是排程資料,不是耗時統計。
### 3. 算出截止日〔可委派〕
所有工作包建立且相依關係確認後,只依已確認的 `startDate`、`days` 與 `depends` 呼叫 `scripts/schedule.js` 計算截止日;這一步只回傳可核對的日期與相依結果,你的環境若能把工作交給子代理,就交出去,只把結果帶回來;不能就自己做。寫入議題、Milestone、看板與其他後續資料不委派。
計算完成後,依序用 `issue-link.js`、`issue-update.js` 與 `project-add.js` 補上既有相依、Milestone、看板、截止日與人天估算。各腳本先 dry-run,再實跑。日期與人天是排程資料,不是耗時統計。
## 邊界
+6
View File
@@ -24,8 +24,14 @@ API 契約文件只能交付在預覽位置或使用者確認的位置;不得
### ELI5 變體
使用者要求 ELI5 時,仍保留原文件的範圍、順序、相依、例外與驗收意義;把術語換成日常說法並補必要的短解釋,不刪除技術限制。圖表要重新繪製成容易閱讀的圖片式視覺,不把 Mermaid 原碼當成交付物,也不只用一個看似精確的日期隱藏 O/M/P 不確定性。
### 把議題標題翻成英文〔可委派〕
把工作包議題標題轉成不超過 40 字元的英文 kebab slug,保留原意且不捏造新範圍;這一步只產出可驗證的 slug,你的環境若能把工作交給子代理,就交出去,只把 slug 帶回來;不能就自己做。若有兩個同樣合理的翻法,交回候選與差異,由主流程詢問使用者。
## 實作與交付
### 分批提交方案〔可委派〕
依檔案類型與變更性質計算 commit 分類、順序與每批檔案;只回傳可核對的提交方案。實際執行 `scripts/commit-split.js`、處理失敗與確認 git 歷史不委派,由主流程自己完成。
完成程式碼待辦後照既有測試與驗證慣例;文件待辦則依上述分流交付。完成後依既有 commit 分類規則提交,先用 `scripts/pr-create.js --dry-run` 檢查,再實跑開 PR。回報工作包、分支、worktree、完成待辦、commit 與 PR。
+19 -5
View File
@@ -7,11 +7,25 @@ description: 僅由 /sdlc-plan 指令叫用。把一段口語需求轉成結構
## 步驟
1. 讀齊輸入,列出九個段落中已有依據與缺漏。
2. 一次問一題補齊缺漏;未獲回答的內容放入「未決事項」,不得自行編造。
3. 套用 `templates/requirement-issue.md`,填入總覽、背景、目標、非目標、領域名詞表、文件、驗收標準、影響範圍與未決事項;全程使用繁體中文。
4. 用 `scripts/labels-list.js` 取得既有標籤,只能選既有標籤。
5. 寫入前先執行:
### 1. 列出九段落依據與缺漏〔可委派〕
讀齊輸入,列出總覽、背景、目標、非目標、領域名詞表、文件、驗收標準、影響範圍與未決事項中已有依據與缺漏。這一步只產出可核對的清單;你的環境若能把工作交給子代理,就交出去,只把清單帶回來;不能就自己做。
### 2. 一次問一題補齊缺漏
一次問一題補齊缺漏;未獲回答的內容放入「未決事項」,不得自行編造。
### 3. 填入需求議題模板
套用 `templates/requirement-issue.md`,填入總覽、背景、目標、非目標、領域名詞表、文件、驗收標準、影響範圍與未決事項;全程使用繁體中文。
### 4. 取得既有標籤
用 `scripts/labels-list.js` 取得既有標籤,只能選既有標籤。
### 5. 試跑並建立議題
寫入前先執行:
```
node scripts/issue-create.js --repo <owner/name> --title "<標題>" --body-file <暫存檔> --labels "<標籤>" --dry-run