aixbdd

當要把一筆需求對齊進 plan package 時觸發，這筆需求可以是對既有規格的變更或缺陷，也可以是要落到既有或全新 plan package 的全新需求。把這筆需求追加進 spec.md 並校準 impact matrix。

跨 skill 共用資源庫，本身不會被執行，只存放供其他 skill 載入的共用資源（reference／asset／script）。

Turn a legal Red handoff for target feature files green by verifying drift, editing product code only, detecting failure oscillation, and emitting a Green handoff. TRIGGER when Green execute is requested after aibdd-red-execute. SKIP when no legal Red handoff exists or the request is test, DSL, runtime, or architecture repair.

當 reconcile 校準 impact matrix 後、本 owner 名下有 pending impact 待落成 persistent data schema 時觸發。以 `read --owner aibdd-data-plan --impact-status pending` 為 worklist，依 Discovery 真相（spec.md／feature truth）把須穩定保存的系統狀態推論成 state schema、在草稿上收斂後委派 boundary profile 宣告之 state_specifier 落地至 `${DATA_DIR}`，最後回寫 impact matrix。

Build the entity-to-table mapping (`entity_to_table_mapping.yml`) from a boundary's physical schema specs (DBML / SQL DDL), preserving existing entity names and naming new tables from the plan spec.

Create legal AIBDD red for target feature files by loading project config, mapping every Scenario step to DSL and core preset assets, rendering runtime-visible step definitions, and emitting a Red handoff. TRIGGER when Red execute is requested or delegated by implementation/debug flow. SKIP when the feature package or BDD stack config is absent.

AIBDD DSL Refine SOP。

專案初始化引導；支援 python_e2e / java_e2e / nextjs_playwright 三種 stack，收集 stack / 規格語言 / service 名 / codebase layout / 是否安裝 aibdd-spectrum，產出 arguments.yml、boundary.yml、component-diagram.class.mmd、isa.yml 與 boundary skeleton。TRIGGER when 使用者說 kickoff、初始化專案、建 arguments.yml、新專案設定。SKIP when 需要多 TLB、Unit Test only、Mobile，或其他尚未支援的 stack。

從 arguments.yml 與 templates 產生 walking skeleton；以 STARTER_VARIANT 分流 frontend / backend。支援 python-e2e（FastAPI + Behave）、java-e2e（Spring Boot 4 + Cucumber）、nextjs-storybook-cucumber-e2e（Next.js 16 + Storybook 10 + playwright-bdd）。TRIGGER when 使用者說初始化前/後端、建前/後端骨架、frontend/backend starter、walking skeleton，或被 kickoff 後續流程委派。SKIP when 需求是 feature-specific 業務頁面/元件/API client/model/service/API/step definition 實作或既有專案重構。

當 reconcile 校準 impact matrix 後、本 owner 名下有 pending impact 待落成 operation contract 時觸發。以 `read --owner aibdd-api-plan --impact-status pending` 為 worklist，依 Discovery 真相（spec.md／feature truth）推論 operation contract、在草稿上收斂後委派 boundary profile 宣告之 operation_contract_specifier 落地至 `${CONTRACTS_DIR}`，最後回寫 impact matrix。

當 reconcile 校準矩陣後、本 owner 名下有 pending impact 待落成 spec 時觸發。以本 owner 的 pending impact 為 worklist，在 function-packaging 劃定的 package 內把需求萃取成 api-wise business action、編織可獨立驗收的 UAT flow 並交 /aibdd-form-activity 產出 `.activity`，再把每個 action 落成 rule-less `.feature` 骨架，最後回寫影響矩陣。當 CWD 下找不到 arguments.yml 須先執行 /aibdd-kickoff。當只是要為既有 `.feature` 列舉 atomic rule 則應使用 /aibdd-rules-specify。

當 reconcile 校準 impact matrix 後、本 owner 名下有 pending impact 待落成 atomic rule 時觸發。以當前 plan package 內 flows-specify 本批次觸動且仍存在的 `.feature` 為工作集，依本 owner pending impact 的 quotes 為每個 `.feature` 列舉 atomic rules（4 種類型前綴、單一主詞／單一條件、可指回需求原文），逐檔當下收斂疑慮，最後回寫 impact matrix。

當 reconcile 校準 impact matrix 後、本 owner 名下有 pending impact 待補 Example 時觸發。以當前 plan package 內 rules-specify 本批次補了 atomic rule 且仍存在的 `.feature` 為工作集，把每條尚無 Example 的 rule 依其類型前綴套對應 4-pattern 模板，將 Example 全部草擬完、批次釐清收斂後一次寫入，最後回寫 impact matrix。當 CWD 下找不到 arguments.yml 須先執行 /aibdd-kickoff；當尚無含 rule 的 `.feature` 須先執行 /aibdd-rules-specify。

接收 caller 交辦的一份推論結果，重讀該批次 spec.md 的原始真相（raw idea 全文與過往澄清），稽核該結果是否依所給 rule 與 example 完整且忠實轉換而成，逐條回報 violations 並標注 `fixable`（真相充分、caller 可就地修正）或 `to-clarify`（真相不足、須回頭向使用者釐清，附上可直接提問的 clarification 內容）。只稽核不修改任何檔案。

從推理包翻譯為「Storybook CSF3 stories + React component implementation 雙產出」。 對 caller 指定的 `target_dir` 寫兩個檔：`<identifier>.tsx`（React component 實作）與 `<identifier>.stories.tsx`（CSF3 stories；boundary I4 binding anchor SSOT）。 目標目錄、props、stories、render hints 由 Planner 透過 DELEGATE 參數指定，本 skill 不自決。 綁定 Storybook 10 + `@storybook/nextjs-vite`；步驟定義從 Story `args` 派生 `getByRole(role, { name })` locator。

當 reconcile 校準 impact matrix 後、要依本批次需求重新對齊各 function package 範圍時觸發。校正 `function-packaging.md` 把每個受牽動的 function package 標記為 `added` 或 `related`，並為 `added` 的 package 建立目錄。

Execute an existing `tasks.md` through TodoWrite-driven task management. Every markdown checkbox becomes exactly one todo item, and both the todo list and `tasks.md` must stay synchronized while execution progresses.

Adapter for Pencil `.pen` design files. Reads `.pen` → returns normalized `component_table` + Tailwind 4 `tokens`. Pure read-only — does NOT write files. Pencil-side adapter implementation of the cross-source design adapter contract; future siblings (`aibdd-figma-to-storybook`, `aibdd-penpot-to-storybook`) follow the same `component_table + tokens` return shape so downstream consumers (`/aibdd-form-story-spec`, `/aibdd-plan` Phase 3 component-design merge, `/aibdd-green-execute` Wave 1) stay design-source-agnostic.

AIBDD Plan SOP。

AIBDD Spec by Example Analyze SOP。

Generate `${CURRENT_PLAN_PACKAGE}/tasks.md` after `/aibdd-plan` by weaving impacted feature scope, implementation topology, and per-feature TDD flow into a structured markdown task list. TRIGGER when the user asks for post-plan task breakdown or `/aibdd-tasks`. SKIP when the current plan package, feature package, or accepted planning artifacts are missing.

接收 planner 的批次疑問 payload，先做共通 schema 檢查與白話文轉譯，再依可用工具分流。優先走 fork；若無 fork，改走 AskUserQuestion／AskQuestion 類互動工具，問完把答案回傳 caller。任何 planner 要向使用者提問都必須 DELEGATE 此 skill，不得自行逐題提問。

clarify AskUserQuestion route。

clarify SpecFormula fork route。

Hierarchical skill 撰寫格式。

SKILL.md 撰寫時避免不必要的 Markdown 裝飾（粗斜底線），並只在表格真的更適合時才使用表格，以 Text Mode 友善的原始排版為主。Use when 撰寫或修改 SKILL.md、skill 正文、或使用者要求簡潔無裝飾的 skill 文件時。

Analyze any skill-set for broken references, unclear SSOT ownership, dead cross-skill targets, obsolete links, and unreachable artifacts. TRIGGER when user asks for skill family consistency, reference integrity, SSOT audit, or /skill-family-consistency-analyze. SKIP when the request is to validate one generated artifact rather than a skill-set.

Perform Skill Root Cause Analysis for defective skill outputs; trace the earliest faulty skill artifact, classify the defect, propose the smallest corrective patch, and optionally apply it after approval. TRIGGER when request says 覆盤, skill RCA, 為什麼 skill 會產出這個錯誤, 追蹤根因, or consistency analysis finds a skill-level issue. SKIP when the defect is only in generated product implementation and no skill artifact caused it.

從推理包翻譯為 OpenAPI。負責 OpenAPI 語法規章 + 歸檔。 切檔策略（單檔 / per-resource / per-module / per-boundary）由 Planner 透過 DELEGATE 參數指定， 本 skill 不自決。不做跨 boundary 決策。

依 `.agents/skills/aibdd-core/references/ssot/skill-writing-criteria/` 底下每一條規則審查 AIBDD skill PR 變更。當需要對 AIBDD skill-writing criteria 做 PR review、產出合併後的 `.reports/report.md`、收集使用者 feedback，並在使用者 confirm 後轉成 quote-and-comment comments plan 時使用。

從推理包翻譯為 SQL DDL（MySQL `.mysql.sql` / PostgreSQL `.pg.sql` / MSSQL `.mssql.sql`）。 負責各方言 DDL 語法規章 + 歸檔。dialect 由 `target_path` 副檔名 SSOT， 不做跨 boundary 決策；路徑 / 切檔策略 / dialect 選擇由 Planner 透過 DELEGATE 參數指定。

從推理包翻譯為 DBML (.dbml)。負責 DBML 語法規章 + 歸檔。 不做跨 boundary 決策；路徑 / 切檔策略由 Planner 透過 DELEGATE 參數指定。

將上游 `/aibdd-flows-specify` 產出的 Activity modeling elements 逐一翻譯成 `.activity` DSL，寫入檔案並執行語法驗證。

幫你畫出非常完整、非常詳細、非常專業的 Mermaid 類別圖。Use when 使用者想畫 class diagram。

一個非常強大、非常完整、幾乎什麼 PDF 問題都能幫你處理的超級技能。Use when 使用者提到 PDF 的任何事情。

用 Mermaid 產出精簡、可維護的類別圖。Use when 使用者需要建立、審查或修正 class diagram，並希望圖面能忠實反映責任分工與關係。

處理 PDF 的讀取、合併、拆分、旋轉、OCR 與表單填寫。Use when 使用者提到 PDF 擷取、合併文件、頁面拆分、掃描檔 OCR 或 PDF 表單處理。

AIBDD feature file writing 原則。規範 `.feature` 必須以 Specification by Example 為 SSOT，Given/When/Then 要資料自足、優先驗證完整結果、覆蓋 negative path 與 idempotency，並優先使用一般化的 fixture-driven、filesystem-oriented、harness CLI 情境來表達規格。

將推理包翻譯為 Mermaid `classDiagram` 檔（`.class.mmd`）。 目標路徑與協作者／關係聯集由呼叫方透過 DELEGATE 參數指定，本 skill 不自決。

將推理包翻譯為 Mermaid `sequenceDiagram` 檔（`.sequence.mmd`）。 目標路徑與單一 implementation path 內容由呼叫方透過 DELEGATE 參數指定，本 skill 不自決。