From d55f1682b7414993f6616349b14998a078c636e1 Mon Sep 17 00:00:00 2001
From: Jeffery <jiantw83@yahoo.com>
Date: Thu, 17 Sep 2026 07:07:01 +0000
Subject: [PATCH] =?UTF-8?q?feat(=E6=B5=81=E7=A8=8B=E6=AD=A3=E6=9C=AC):=20?=
 =?UTF-8?q?=E6=96=B0=E5=A2=9E=20sdlc-feat=20=E8=88=87=E5=AE=83=E7=9A=84?=
 =?UTF-8?q?=E7=AC=AC=E4=B8=80=E6=AE=B5=E3=80=8C=E9=A0=98=E5=8F=96=E8=88=87?=
 =?UTF-8?q?=E9=96=8B=E5=B7=A5=E6=BA=96=E5=82=99=E3=80=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

第一段把工作包安全地認領下來、起錶、備妥分支，不改任何一行程式碼——它只負責讓後面的
實作有個乾淨的起點。

正本負責三件腳本做不到的事：讀完工作包後，未處理留言不是 0 就先停下來建議整併；
新分支從哪裡長出來要問過使用者，一次一題、附理由、永遠留手動輸入；議題標題翻成英文
kebab 也是 agent 的事，腳本只驗格式。

領取鎖的四種狀態連同放行那一種都列在表上，缺標籤則另外交代——它是 repo 的前置條件，
不是鎖的第五種狀態，混在一起會讓決策表說不清楚。

工作包跨多個 repo 時逐一確認要在哪幾個開分支，分支名在每個 repo 都相同。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 prompts/sdlc-feat.md | 117 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 prompts/sdlc-feat.md

diff --git a/prompts/sdlc-feat.md b/prompts/sdlc-feat.md
new file mode 100644
index 0000000..66938c3
--- /dev/null
+++ b/prompts/sdlc-feat.md
@@ -0,0 +1,117 @@
+name: sdlc-feat
+description: 僅由 /sdlc-feat 指令叫用。領取一顆工作包、起錶、備妥分支，逐項實作並勾選待辦，最後分批提交並開立 PR。
+
+# sdlc-feat
+
+拿一顆工作包，從領取到開出 PR。
+
+第一段**領取與開工準備**：把工作包安全地認領下來，開始計時，備妥開工的分支。
+這一段不改任何一行程式碼——它只負責讓後面的實作有個乾淨的起點。
+
+這份檔案是流程正本。各平台的轉接檔只是指回這裡，不要把規則抄過去。
+
+## 輸入
+
+一個工作包議題編號。
+
+## 第一段：領取與開工準備
+
+### 1. 讀工作包
+
+```
+node scripts/wp-extract.js --repo <owner/name> --index <編號>
+```
+
+拿到的是結構化欄位：待辦與它自己的驗收、範圍邊界、介面契約、相依、repo 列表。
+不必再讀整份議題全文。
+
+**先看 `未處理留言數`。** 只要不是 0，就代表議題描述可能是過期的——留言裡有決策還沒被
+整併回描述。這時**先停下來**告訴使用者有幾則未整併的留言，建議先執行 `/sdlc-sync`
+把它們整併回描述，再回來實作。使用者堅持要繼續就繼續，但要記下這件事，
+並在最後的 PR 描述裡註明「實作基於未整併留言前的描述」。
+
+**再看 `相依.depends`。** 裡面還有沒關閉的議題，代表這顆的前置還沒做完。照樣先說出來，
+讓使用者決定要不要現在做。
+
+### 2. 領取工作包
+
+先試跑，看清楚會做什麼：
+
+```
+node scripts/claim.js --repo <owner/name> --index <編號> --dry-run
+```
+
+確認無誤後拿掉旗標再跑一次。放行時它會設 assignee、貼「進行中」標籤、起錶——三件事
+一起構成領取鎖，錶則是工時的來源。
+
+領取鎖有四種狀態，三種擋、一種放行。被擋下來時**不要繞過去**，照著錯誤碼告訴使用者
+發生什麼事、下一步是什麼：
+
+| 狀態 | 錯誤碼 | 下一步 |
+| --- | --- | --- |
+| 別人已經認領這顆 | `CLAIMED_BY_OTHER` | 改領別顆，或先跟對方確認 |
+| 你的錶已經跑在這顆上 | `STOPWATCH_ON_THIS_ISSUE` | 這顆你正在做；要重新計時請先手動停錶 |
+| 你的錶跑在別的議題上 | `STOPWATCH_ON_OTHER_ISSUE` | 多半是忘了停上一顆；先去停掉再回來 |
+| 沒有鎖 | —— | 放行。自己已認領但沒起錶也算沒有鎖，那正是中斷後重跑的情形 |
+
+碼錶一律由使用者自己停。哪一段時間該記在哪顆議題上只有他知道，代勞會把工時記錯地方。
+
+鎖以外還有一個前置條件：repo 上要有「進行中」標籤。缺了會得到 `LABEL_NOT_FOUND`，
+請使用者自己去建立——**不要自己建**，標籤體系不該在多個 repo 之間長出雜草。
+
+### 3. 問來源分支
+
+**一次問一題。** 新分支要從哪裡長出來，只有使用者知道，不要替他決定。
+給兩個選項，並附上你判斷的理由：
+
+- **建議** — 你的答案。多數情況是開發分支（`master`／`main`／`develop`）；
+  但若這顆工作包明顯是某個既有功能分支的一部分，就建議那一支，並說明為什麼。
+- **手動輸入** — 讓使用者自己填分支名。
+
+### 4. 把議題標題翻成英文
+
+分支名的中段要用英文，中文會讓 CI 與 URL 出問題。把工作包議題的標題翻成
+**小寫英文 kebab、40 字元以內**，例如「建立工作包的抽取契約」→ `wp-extract-contract`。
+
+翻譯要保留原意而不是逐字直譯，寧可用一個更短的說法，也不要把長句截斷成看不懂的字串。
+
+### 5. 備妥分支
+
+分支開在**工作包的 `repos` 列出的那些 repo** 上，不是開在本 plugin 的目錄裡。
+`repos` 只有一顆就用那一顆；**有多顆時逐一確認**要在哪幾個開分支，
+再對每一個各跑一次 `branch-prep`，分支名在每個 repo 都相同。
+
+```
+node scripts/branch-prep.js --path <目標專案路徑> --source <來源分支> \
+  --slug <英文-kebab> [--type feat] --dry-run
+```
+
+`--type` 只在來源是開發分支時要給（`feat`／`fix`／`chore`…）；從功能分支長出時，
+類型與需求描述沿用來源，不必也不能再指定。
+
+試跑會印出將執行的 git 指令與算出來的分支名。確認無誤後拿掉旗標再跑一次。
+
+它保證三件事，都是為了不弄丟別人的東西：工作區不乾淨時**先擋下來**，免得把不相干的
+改動帶進這顆工作包的分支；來源分支在遠端已存在時是 **pull 而不是重建**；目標分支已經
+存在時是**接上去而不是蓋掉**。
+
+工作區不乾淨（`DIRTY_WORKTREE`）時，把 git 回報的檔案念給使用者聽，讓他決定要提交、
+`git stash` 還是丟掉——**不要自己選**。
+
+### 6. 回報
+
+印出一份開工前的現況，不寫回議題：
+
+- 工作包標題與網址、這一顆有幾項待辦
+- 認領結果（是否本來就是自己的）、碼錶已起
+- 來源分支、新分支名、分支是新建還是接上既有
+- 未處理留言數與未關閉的先決議題（若有）
+
+## 邊界
+
+- 第一段**不改任何一行程式碼**、不勾待辦、不提交、不開 PR——那些是後面幾段的事。
+- 不自行建立標籤。缺「進行中」標籤時中止並請使用者建立。
+- 不代替使用者停錶，也不在被鎖擋下時繞過去。
+- 不替使用者決定來源分支。
+- **不寫任何本機狀態檔。** 進度完全由 Gitea 上的 assignee、標籤、碼錶與 git 本身推導，
+  換一台機器或換一個 agent 都要能直接接手。