From c56f3271b5180b59ba663ebfd1bd412def6f8eff Mon Sep 17 00:00:00 2001 From: Jeffery Date: Tue, 22 Sep 2026 15:31:36 +0800 Subject: [PATCH] =?UTF-8?q?feat(workflow-assets):=20=E6=95=B4=E5=90=88?= =?UTF-8?q?=E6=B5=81=E7=A8=8B=E6=AD=A3=E6=9C=AC=E8=88=87=E5=A7=94=E6=B4=BE?= =?UTF-8?q?=E8=A6=8F=E5=89=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 以能力描述補齊可委派步驟,讓流程正本、委派規則、AGENTS、README 與 ADR 保持同一份繁體中文與 UTF-8 契約。 --- prompts/sdlc-analyze.md | 11 ++++++++++- prompts/sdlc-feat.md | 6 ++++++ prompts/sdlc-plan.md | 24 +++++++++++++++++++----- references/delegation.md | 10 ++++------ 4 files changed, 39 insertions(+), 12 deletions(-) diff --git a/prompts/sdlc-analyze.md b/prompts/sdlc-analyze.md index eba8b97..ef7dadc 100644 --- a/prompts/sdlc-analyze.md +++ b/prompts/sdlc-analyze.md @@ -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,再實跑。日期與人天是排程資料,不是耗時統計。 ## 邊界 diff --git a/prompts/sdlc-feat.md b/prompts/sdlc-feat.md index 911d7ac..6b9f401 100644 --- a/prompts/sdlc-feat.md +++ b/prompts/sdlc-feat.md @@ -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。 diff --git a/prompts/sdlc-plan.md b/prompts/sdlc-plan.md index 7385ba2..c9387db 100644 --- a/prompts/sdlc-plan.md +++ b/prompts/sdlc-plan.md @@ -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 --title "<標題>" --body-file <暫存檔> --labels "<標籤>" --dry-run diff --git a/references/delegation.md b/references/delegation.md index ec9fca3..e6b71de 100644 --- a/references/delegation.md +++ b/references/delegation.md @@ -36,8 +36,7 @@ 一個步驟裡只有一半合判準時,**標記照下,並在該步寫明哪一半不委派**。這比整步不標好—— 不標的話那一半的中間產物照樣塞滿主脈絡;也比整步委派安全,因為第四條是硬排除。 -目前有三步是這個形狀:兩份圖解總覽(產出 HTML 可委派,寫回議題的 `issue-update` 不委派) -與分批提交(方案計算可委派,實際跑 `commit-split.js` 不委派)。 +目前有一步是這個形狀:分批提交的方案計算可委派,實際跑 `commit-split.js` 不委派。 ## 目前標記為〔可委派〕的步驟 @@ -46,12 +45,11 @@ | 正本 | 步驟 | 委派範圍 | | --- | --- | --- | -| `sdlc-plan` | 產生圖解版總覽 | 產出 HTML;寫回議題不委派 | +| `sdlc-plan` | 列出九段落依據與缺漏 | 產出可核對的清單 | | `sdlc-analyze` | 對四份清單列出疑點 | 全步 | -| `sdlc-analyze` | 算出截止日 | 全步 | -| `sdlc-analyze` | 產生分析版的圖解總覽 | 產出 HTML;寫回議題不委派 | +| `sdlc-analyze` | 算出截止日 | 計算日期;寫回議題不委派 | | `sdlc-feat` | 把議題標題翻成英文 | 全步 | -| `sdlc-feat` | 分批提交 | 方案計算;實際提交不委派 | +| `sdlc-feat` | 分批提交方案 | 方案計算;實際提交不委派 | `sdlc-sync`、`sdlc-fix` 與 `sdlc-report` 目前沒有可委派的步驟:前兩者每一步都在問使用者 或寫入 Gitea,後者只有一支唯讀腳本,委派出去省不到什麼。