feat(workflow-assets): 整合流程正本與委派規則
以能力描述補齊可委派步驟,讓流程正本、委派規則、AGENTS、README 與 ADR 保持同一份繁體中文與 UTF-8 契約。
This commit is contained in:
+10
-1
@@ -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,再實跑。日期與人天是排程資料,不是耗時統計。
|
||||
|
||||
## 邊界
|
||||
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user