| name | aibdd-auto-tdd |
| description | AIBDD TDD 流程統一決策中心——8 個 stage（control-flow / red / green / refactor / code-quality / step-template / schema-analysis / starter / test-skeleton）× 3 語言（C# / PHP / TypeScript）的合一入口。 從用戶 prompt（紅燈 / 綠燈 / 重構 / control-flow / starter / 批次跑 BDD 等）觸發， 依語言推斷與 stage 路由載入對應 references/{stage}/{language}.md。 當用戶說「紅燈」「綠燈」「control-flow」「跑 BDD 自動化」「重構」「TDD 批次」 「BDD pipeline」「test skeleton」「step template」「schema 分析」「骨架建立」 「初始化專案」「scaffold」「建專案」「make tests pass」「failing test」等 觸發詞時啟用。
|
AIBDD Auto TDD 統一決策中心
本 skill 是 stage × language 的雙軸路由樞紐。從觸發訊號決定 stage 與 language，再載入對應 reference。
單一入口、user-invocable：所有 BDD/TDD 自動化（control-flow / red / green / refactor / starter）皆透過本 skill 觸發。原本的 5 個薄皮 skill（aibdd-auto-control-flow / aibdd-auto-red / aibdd-auto-green / aibdd-auto-refactor / aibdd-auto-backend-starter）已合併入此 skill；外部呼叫一律改用 /aibdd-auto-tdd（stage=...） 形式。
Trigger 辨識
下列觸發詞之一出現於 prompt 即啟用，依關鍵字推斷 stage：
| 觸發詞 | 推斷 stage |
|---|
| 「紅燈」「red」「跑紅燈」「實作測試」「failing test」 | red |
| 「綠燈」「green」「跑通測試」「讓測試過」「make tests pass」「修綠燈」 | green |
| 「重構」「refactor」「清理程式碼」 | refactor |
| 「control-flow」「批次執行」「跑 BDD 自動化」「TDD 批次」「pipeline」「批次跑 BDD」「自動化跑」 | control-flow |
| 「starter」「scaffold」「scaffolding」「初始化專案」「骨架建立」「建專案」「建立後端骨架」 | starter |
| 「step template」「step 骨架」「step 模板」 | step-template |
| 「schema 分析」「schema-analysis」「schema 對齊」 | schema-analysis |
| 「test skeleton」「test 骨架」「PHPUnit 骨架」 | test-skeleton |
| 「code quality」「品質規範」「code-quality」 | code-quality |
主 SKILL.md 完成 (stage, lang) 雙軸路由後，先 Read references/{stage}/_stage-flow.md（語言無關流程）→ 再 Read references/{stage}/{language}.md（語言特化）。
Stage 流程圖
8 個 stage 的依賴關係（DAG），詳細圖見 references/pipeline-overview.md：
┌───────────────┐
│ starter │ (csharp / typescript only)
└──────┬────────┘
│
┌──────▼────────┐
│ control-flow │ (掃描 .feature → 派發迴圈)
└──────┬────────┘
│
┌──────────────────┼──────────────────┐
│ │ │
┌───────▼─────┐ ┌───────▼──────┐ ┌─────▼──────────┐
│schema- │ │step-template │ │ test-skeleton │
│analysis │ │ │ │ (php only) │
└───────┬─────┘ └───────┬──────┘ └─────┬──────────┘
│ │ │
└──────────────────▼──────────────────┘
│
┌──────▼────────┐
│ red │ (測試先失敗)
└──────┬────────┘
│
┌──────▼────────┐
│ green │ (最小增量讓測試過)
└──────┬────────┘
│
┌──────▼────────┐
│ refactor │ ◄── code-quality（refactor 載入規範）
└───────────────┘
三語言 stage 矩陣
| Stage | csharp | php | typescript |
|---|
| control-flow | OK | OK | OK |
| red | OK | OK | OK |
| green | OK | OK | OK |
| refactor | OK | OK | OK |
| code-quality | OK | OK | OK |
| step-template | OK | N/A | OK |
| schema-analysis | OK | N/A | OK |
| starter | OK | N/A | OK |
| test-skeleton | N/A | OK | N/A |
合計 27 格 = 22 實 + 5 N/A stub。
Stage 串接
本 skill 內部依 stage 串接 sub-stage，使用者只需以「stage=…」起點觸發即可：
| 入口 stage | 內部串接 |
|---|
starter | 單獨呼叫；完成後依語言交給 discovery（greenfield）或 control-flow（已有 specs） |
control-flow | 掃描 features → 對每個 feature 依語言變體展開 phase（schema-analysis → step-template → red → green → refactor，PHP 為 test-skeleton → red → green → refactor） |
red / green / refactor | 可單獨被 user 觸發；亦可被 control-flow phase 依序內部呼叫 |
control-flow 不對外委派其他 skill，每個 phase 都是 Read 同 skill 的 references/{stage}/{lang}.md 完成。
語言推斷
讀取專案根目錄訊號決定 language：
| 訊號 | 推斷 lang |
|---|
*.csproj / appsettings.json / Program.cs 存在 | csharp |
composer.json 含 wordpress 或 wp-env 設定檔 | php |
package.json 含 react / vitest / @testing-library/react | typescript |
package.json 含 express / drizzle-orm / prisma（Node.js 後端） | nodejs（= typescript alias） |
nodejs alias：kickoff / specformula 支援的 nodejs 專案在本 skill 一律視為 typescript——路由沿用 references/{stage}/typescript.md，不另建 nodejs references。
推不出時詢問
無明確訊號或多個訊號並存時，以 AskUserQuestion 詢問：
偵測到多個技術棧訊號（或未偵測到）。請選擇本次 TDD 工作的目標語言：
A. C# (.NET 8 / EF Core / SpecFlow)
B. PHP (WordPress / PHPUnit)
C. TypeScript (React / Vitest / MSW)
D. TypeScript (Node.js 後端 / Express / Drizzle / Prisma)
不要憑直覺猜；缺訊號時必問。
Stage 路由表
決定 (stage, lang) 後，依下表 Read 對應 reference（先 _stage-flow.md，再語言檔）：
| Stage | csharp | php | typescript |
|---|
| control-flow | references/control-flow/csharp.md | references/control-flow/php.md | references/control-flow/typescript.md |
| red | references/red/csharp.md | references/red/php.md | references/red/typescript.md |
| green | references/green/csharp.md | references/green/php.md | references/green/typescript.md |
| refactor | references/refactor/csharp.md | references/refactor/php.md | references/refactor/typescript.md |
| code-quality | references/code-quality/csharp.md | references/code-quality/php.md | references/code-quality/typescript.md |
| step-template | references/step-template/csharp.md | references/step-template/php.md (N/A stub) | references/step-template/typescript.md |
| schema-analysis | references/schema-analysis/csharp.md | references/schema-analysis/php.md (N/A stub) | references/schema-analysis/typescript.md |
| starter | references/starter/csharp.md | references/starter/php.md (N/A stub) | references/starter/typescript.md |
| test-skeleton | references/test-skeleton/csharp.md (N/A stub) | references/test-skeleton/php.md | references/test-skeleton/typescript.md (N/A stub) |
N/A stub 不代表「請略過」——而是代表「此語言走另一路徑」。每份 stub 內含「替代路徑」指引，務必 Read 後依指引轉向。
nodejs 無獨立欄位——nodejs 為 typescript 的 alias，一律查 typescript 欄。
共用規則（跨語言適用）
audit 觀察三語言 80%+ 雷同的規則抽至此處，各 reference 不再重複。
CR1：紅燈/綠燈/重構三相循環
- Red：測試先寫且必須失敗（環境正常但 Value Difference）；若失敗訊息為「環境問題」（連不上 DB / 找不到專案），不算合格紅燈，必須先修環境。
- Green：以最小增量讓單一測試通過，不過度設計、不預期未來需求。
- Refactor：在綠燈保護下兩階段——Phase A 先清理測試碼、Phase B 再清理生產碼；每一小步都跑測試確認不破壞。
CR2：中文狀態映射
Gherkin 中文業務術語（「進行中」「已完成」「已付款」等）一律映射為 enum 值；映射表共用，見 aibdd-handlers/SKILL.md §中文狀態對應表。前端 UI 顯示中文是例外（不反映射），其他場景禁止憑空猜測。
CR3：嚴格順序（strict ordering）
control-flow 派發迴圈時，每個 .feature 嚴格依「schema-analysis → step-template → red → green → refactor」順序展開（PHP 變體改為「test-skeleton → red → green → refactor」），不得跳階。每階段未通過完成條件不得進入下一階段。
CR4：Lazy loading
- 主 SKILL.md（本檔）只載入決策骨架，不內嵌任何語言特化程式碼。
- 決定 (stage, lang) 後才 Read 對應 reference（先
_stage-flow.md 再 {lang}.md）。
- reference 內若需 handler 程式碼，再進一步路由至
aibdd-handlers (handler=…, lang=…)，不在本 skill 重抄。
CR5：Handler 路由保留
aibdd-handlers 是獨立 skill（refactor-2 產出），各 reference 中見到 aibdd-handlers (handler=…, lang=…) 引用時保持該路由不變，不要把 handler 內容合進本 skill。
載入語言特化 reference 的標準流程
- 辨識 trigger → 推斷 stage（用戶 prompt 或上游 prompt 含
stage=…）。
- 推斷 lang（讀取訊號或詢問用戶）。
- 查 Stage 路由表 → 取得 reference 路徑。
- Read
references/{stage}/_stage-flow.md（語言無關流程骨架）。
- Read
references/{stage}/{lang}.md（語言特化參數與範例）：
- 若該格為 N/A stub → 依 stub 中的「替代路徑」轉向（通常指向 step-template 或下一 stage）。
- 若為實 reference → 依 reference 的「完成條件」執行。
- 跨 stage cross-link：reference 內若需引用其他 stage，使用
§stage X 章節 (lang=Y) 錨點或重新呼叫 aibdd-auto-tdd (stage=X, lang=Y)。
與 aibdd-handlers 的關係
aibdd-handlers 處理「step 句型 → handler 類型 → 程式碼樣板」（refactor-2 已合併完成）。aibdd-auto-tdd（本 skill）處理「stage × language → 流程 reference」（refactor-3 進行中）。- 兩者正交：red / step-template / refactor 等 reference 內仍會引用
aibdd-handlers (handler=…, lang=…)，這些引用保持不變。
完成條件 / Hand-off
- 收到觸發 → 完成 (stage, lang) 雙軸路由 → Read
_stage-flow.md + {lang}.md → 執行對應 reference 的完成條件 → 回報結果。
- 路由失敗（缺訊號且用戶未回覆）→ 暫停並等待 AskUserQuestion 答覆。
- 跨 stage 串接：每完成一階段，自動展開下一階段 TODO（control-flow 變體會做這件事）。
Hand-off / Next Agent
- 本 skill 為 refactor-3 Stage C 交付物，路徑
skills/aibdd-auto-tdd/SKILL.md。
- Stage C 完成項：
- 主 SKILL.md 吸收 5 薄皮觸發詞 + 確立「先
_stage-flow.md 再 {lang}.md」流程
- 下游 7 個檔案引用切換為
/aibdd-auto-tdd（stage=...）（aibdd-handlers、aibdd-specformula SKILL + assets + references、aibdd-kickoff SKILL + references、README.md、本 SKILL 自身）
