以 sdlc-feat 逐項實作並即時勾選待辦 #12

Closed
opened 2026-09-17 03:51:22 +00:00 by jiantw83 · 0 comments
Member

母議題

#1 — tea-sdlc:以 tea 驅動 SDLC 全流程的跨平台指令組

要做出什麼

開發者跑完這一段,工作包的待辦一項項被實作並勾選,議題頁的進度條隨時反映真實狀態。

過程不打斷:二十項待辦不會被問二十次同意,只印進度;也不會每完成一項就在議題上留一則留言把版面洗掉。

改檔之前先依專案檔(*.csproj/composer.json/package.json/go.mod/pom.xml/pyproject.toml)偵測語言與框架,對照註解格式表,讓註解符合該語言慣例;偵測不到就停下來問,不猜。

分層判定以職責而非目錄:對外介面即控制層,寫功能註解;所有邏輯在服務層,寫邏輯註解並標註所有呼叫的方法(讓 reviewer 追得到呼叫鏈);任何碰 DB/API/資料來源者為存取層,寫資料源註解。所有屬性都要有用途註解,屬性本身是類別時遞迴處理,並附真實資料範例——優先從 MCP 取得,取不到則以邏輯推理並明確註明來源未經驗證。

勾選 checkbox 時用抽取契約給的 raw 做精確字串替換,只動目標那一行。

驗收標準

  • 實作規範與註解格式對照表以規則正本形式存在於本 plugin 內,不寫入任何目標專案的檔案
  • 改檔前依專案檔偵測語言;偵測不到即停止並詢問,不自行假設
  • 控制層寫功能註解、服務層寫邏輯註解並標註所有呼叫的方法、存取層寫資料源註解
  • 所有屬性有用途註解,屬性為類別時遞迴處理,並附真實資料範例
  • 範例無法從 MCP 取得時,明確註明「由邏輯推理、未經驗證」
  • 每完成一項待辦即勾選,不逐項徵求同意、不產生逐項留言,只印進度
  • 勾選以 raw 精確替換:只動目標行、文字重複時不誤傷、raw 不匹配時回傳錯誤而非盲改
  • 中斷後重跑指令能從 Gitea 上的勾選狀態自動接續

阻擋於

  • #11 — 以 sdlc-feat 領取工作包、起錶並備妥分支
## 母議題 #1 — tea-sdlc:以 tea 驅動 SDLC 全流程的跨平台指令組 ## 要做出什麼 開發者跑完這一段,工作包的待辦一項項被實作並勾選,議題頁的進度條隨時反映真實狀態。 過程不打斷:二十項待辦不會被問二十次同意,只印進度;也不會每完成一項就在議題上留一則留言把版面洗掉。 改檔之前先依專案檔(`*.csproj`/`composer.json`/`package.json`/`go.mod`/`pom.xml`/`pyproject.toml`)偵測語言與框架,對照註解格式表,讓註解符合該語言慣例;偵測不到就停下來問,不猜。 分層判定以職責而非目錄:對外介面即控制層,寫功能註解;所有邏輯在服務層,寫邏輯註解並標註所有呼叫的方法(讓 reviewer 追得到呼叫鏈);任何碰 DB/API/資料來源者為存取層,寫資料源註解。所有屬性都要有用途註解,屬性本身是類別時遞迴處理,並附真實資料範例——優先從 MCP 取得,取不到則以邏輯推理並明確註明來源未經驗證。 勾選 checkbox 時用抽取契約給的 `raw` 做精確字串替換,只動目標那一行。 ## 驗收標準 - [x] 實作規範與註解格式對照表以規則正本形式存在於本 plugin 內,不寫入任何目標專案的檔案 - [x] 改檔前依專案檔偵測語言;偵測不到即停止並詢問,不自行假設 - [x] 控制層寫功能註解、服務層寫邏輯註解並標註所有呼叫的方法、存取層寫資料源註解 - [x] 所有屬性有用途註解,屬性為類別時遞迴處理,並附真實資料範例 - [x] 範例無法從 MCP 取得時,明確註明「由邏輯推理、未經驗證」 - [x] 每完成一項待辦即勾選,不逐項徵求同意、不產生逐項留言,只印進度 - [x] 勾選以 `raw` 精確替換:只動目標行、文字重複時不誤傷、`raw` 不匹配時回傳錯誤而非盲改 - [x] 中斷後重跑指令能從 Gitea 上的勾選狀態自動接續 ## 阻擋於 - #11 — 以 sdlc-feat 領取工作包、起錶並備妥分支
jiantw83 added the ready-for-agent label 2026-09-17 03:51:22 +00:00
jiantw83 added a new dependency 2026-09-17 03:51:40 +00:00
jiantw83 added a new dependency 2026-09-17 03:51:40 +00:00
jiantw83 removed the ready-for-agent label 2026-09-17 07:47:05 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: plugins/tea-sdlc#12