plugins/tea-sdlc
2
0
Fork 0
Code Issues 3 Pull Requests Actions Releases Activity

以能力描述表達委派並標記可委派步驟 #58

New Issue
Closed
opened 2026-09-17 10:00:45 +00:00 by jiantw83 · 1 comment
jiantw83 commented 2026-09-17 10:00:45 +00:00
Member
Copy Link
Copy Source

母議題

#56 — 補上六個指令走通後浮現的四個缺口

要做出什麼

只在意結果的步驟不再把過程塞進主 agent 的脈絡。把議題標題翻成英文 kebab、依相依關係算截止日、把四份可行性清單逐條比對出疑點、產生一份 HTML 總覽——這些步驟的中間產物（讀進來的整份清單、試了又丟的譯名、算到一半的拓撲排序）目前全部留在主脈絡裡，把後面真正需要判斷力的步驟愈擠愈窄。

流程正本在這些步驟的標題後綴 〔可委派〕，並以能力描述而非工具名說明怎麼委派：「這一步只在意結果；你的環境若能把工作交給子代理，就交出去，只把結果帶回來；不能就自己做。」不指名任何平台的工具——子代理是平台專屬能力，而流程正本必須保持平台中立。這個寫法對不支援子代理的平台是自然降級，同一份正本兩邊都讀得通，不需要兩套。

判準寫進一份新的規則正本，四條全部成立才可委派：產出是可驗證的成品；步驟中不會詢問使用者；失敗能被呼叫端偵測；只產出草稿或唯讀結果，不直接寫入 Gitea 或 git。

第二條是硬排除——子代理問不到使用者，一旦卡在提問就只能自行決定。第四條的理由不是子代理做不好，而是它的失敗沒有人看著：備妥工作樹失敗會中止整個領取、實際提交失敗會留下半套 git 歷史，這兩種都需要當場有人判斷下一步。

未被取代：#4 的驗收標準「流程正本為平台中立 markdown，不含任何平台專屬語法」繼續成立。以能力描述表達委派正是為了讓它繼續成立。

實作順序：本工作包被計時那一包阻擋。兩者都動 sdlc-plan 與 sdlc-analyze 的正本，而計時是插入新步驟、本包是在既有步驟上加標記；先插入再標記，標記才落在穩定的步驟編號上。

驗收標準

  • 新增 references/delegation.md，載明四條判準，沿用既有規則正本的英文檔名與開頭形狀
  • 流程正本以能力描述說明委派，不出現任何平台的子代理工具名稱
  • 可委派步驟以標題後綴 〔可委派〕 標記，不使用 emoji 或 HTML 註解
  • 被標記的步驟為六個：sdlc-feat 的翻譯分支名、分批方案計算；sdlc-analyze 的對四份清單列疑點、算截止日、產生圖解總覽；sdlc-plan 的產生圖解總覽
  • 所有會詢問使用者的步驟一律未被標記
  • 被標記的步驟皆不直接寫入 Gitea 或執行 git 寫入；分批提交僅委派方案計算，實際 commit 由主流程執行
  • 流程正本資產測試新增雙向斷言：正本上被標記的步驟集合等於 delegation.md 列出的集合
  • 測試涵蓋「問到共識類步驟一律未被標記」，作為判準第二條的迴歸保護
  • #4 的平台中立驗收標準仍然通過

更正（2026-09-18）：原本這一條寫「六個」卻列了七項。多出來的 sdlc-feat 的「認出語言，讀規則正本」含「認不出語言就停下來問、不要猜」，正是判準第二條硬排除的事，也與下一條「所有會詢問使用者的步驟一律未被標記」牴觸。排掉它之後剛好六個，數字與列舉兩邊都成立。

阻擋於

  • #57 — 為規劃與分析階段計時並補登規劃時間
## 母議題 #56 — 補上六個指令走通後浮現的四個缺口 ## 要做出什麼 只在意結果的步驟不再把過程塞進主 agent 的脈絡。把議題標題翻成英文 kebab、依相依關係算截止日、把四份可行性清單逐條比對出疑點、產生一份 HTML 總覽——這些步驟的中間產物（讀進來的整份清單、試了又丟的譯名、算到一半的拓撲排序）目前全部留在主脈絡裡，把後面真正需要判斷力的步驟愈擠愈窄。 流程正本在這些步驟的標題後綴 `〔可委派〕`，並以**能力描述而非工具名**說明怎麼委派：「這一步只在意結果；你的環境若能把工作交給子代理，就交出去，只把結果帶回來；不能就自己做。」不指名任何平台的工具——子代理是平台專屬能力，而流程正本必須保持平台中立。這個寫法對不支援子代理的平台是自然降級，同一份正本兩邊都讀得通，不需要兩套。 判準寫進一份新的規則正本，四條全部成立才可委派：產出是可驗證的成品；**步驟中不會詢問使用者**；失敗能被呼叫端偵測；**只產出草稿或唯讀結果，不直接寫入 Gitea 或 git**。 第二條是硬排除——子代理問不到使用者，一旦卡在提問就只能自行決定。第四條的理由不是子代理做不好，而是它的失敗沒有人看著：備妥工作樹失敗會中止整個領取、實際提交失敗會留下半套 git 歷史，這兩種都需要當場有人判斷下一步。 **未被取代**：#4 的驗收標準「流程正本為平台中立 markdown，不含任何平台專屬語法」繼續成立。以能力描述表達委派正是為了讓它繼續成立。 **實作順序**：本工作包被計時那一包阻擋。兩者都動 `sdlc-plan` 與 `sdlc-analyze` 的正本，而計時是插入新步驟、本包是在既有步驟上加標記；先插入再標記，標記才落在穩定的步驟編號上。 ## 驗收標準 - [x] 新增 `references/delegation.md`，載明四條判準，沿用既有規則正本的英文檔名與開頭形狀 - [x] 流程正本以能力描述說明委派，不出現任何平台的子代理工具名稱 - [x] 可委派步驟以標題後綴 `〔可委派〕` 標記，不使用 emoji 或 HTML 註解 - [x] 被標記的步驟為六個：`sdlc-feat` 的翻譯分支名、分批方案計算；`sdlc-analyze` 的對四份清單列疑點、算截止日、產生圖解總覽；`sdlc-plan` 的產生圖解總覽 - [x] 所有會詢問使用者的步驟一律未被標記 - [x] 被標記的步驟皆不直接寫入 Gitea 或執行 git 寫入；分批提交僅委派方案計算，實際 commit 由主流程執行 - [x] 流程正本資產測試新增雙向斷言：正本上被標記的步驟集合等於 `delegation.md` 列出的集合 - [x] 測試涵蓋「問到共識類步驟一律未被標記」，作為判準第二條的迴歸保護 - [x] `#4` 的平台中立驗收標準仍然通過 **更正（2026-09-18）**：原本這一條寫「六個」卻列了七項。多出來的 `sdlc-feat` 的「認出語言，讀規則正本」含「認不出語言就停下來問、不要猜」，正是判準第二條硬排除的事，也與下一條「所有會詢問使用者的步驟一律未被標記」牴觸。排掉它之後剛好六個，數字與列舉兩邊都成立。 ## 阻擋於 - #57 — 為規劃與分析階段計時並補登規劃時間
jiantw83 added the ready-for-agent label 2026-09-17 10:00:45 +00:00
jiantw83 added a new dependency 2026-09-17 10:00:45 +00:00
#57 為規劃與分析階段計時並補登規劃時間
jiantw83 commented 2026-09-18 01:47:35 +00:00
Author
Member
Copy Link
Copy Source

驗收標準九條逐條對照合併後的 master 驗過，全部達成，已勾選。

實作見 PR #64（已合併至 master，c545f11）。合併後全測 878 / 878 過。

兩處與原規格不同，都經過確認：第 4 條原本寫「六個」卻列七項，多出來的「認出語言，讀規則正本」含「認不出語言就停下來問」，與判準第二條硬排除牴觸，已移除並在描述裡註明；兩份圖解總覽採部分委派（委派產出 HTML、寫回議題不委派），與分批提交同一個形狀。

驗收標準九條逐條對照合併後的 master 驗過，全部達成，已勾選。 實作見 PR #64（已合併至 master，`c545f11`）。合併後全測 878 / 878 過。 兩處與原規格不同，都經過確認：第 4 條原本寫「六個」卻列七項，多出來的「認出語言，讀規則正本」含「認不出語言就停下來問」，與判準第二條硬排除牴觸，已移除並在描述裡註明；兩份圖解總覽採部分委派（委派產出 HTML、寫回議題不委派），與分批提交同一個形狀。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ready-for-agent
規格已就緒可交由agent實作
 進行中
工作包正在實作
No labels ready-for-agent
Milestone
No items
No Milestone
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Depends on
#57 為規劃與分析階段計時並補登規劃時間
plugins/tea-sdlc
Reference: plugins/tea-sdlc#58