メニュー
從推理包翻譯為 OpenAPI。負責 OpenAPI 語法規章 + 歸檔。 切檔策略（單檔 / per-resource / per-module / per-boundary）由 Planner 透過 DELEGATE 參數指定， 本 skill 不自決。不做跨 boundary 決策。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | aibdd-form-api-spec |
| description | 從推理包翻譯為 OpenAPI。負責 OpenAPI 語法規章 + 歸檔。 切檔策略（單檔 / per-resource / per-module / per-boundary）由 Planner 透過 DELEGATE 參數指定， 本 skill 不自決。不做跨 boundary 決策。 |
| user-invocable | false |
Formulation skill。綁定 DSL = OpenAPI 3.x。被 aibdd-service-contract-analysis 與 /aibdd-plan（透過 boundary operation contract specifier）DELEGATE。
接收推理包：
| 項目 | 內容 |
|---|---|
| M/D/C 變更集 | EndpointGroup / InteractionMode / ModuleSlice 的增刪改 |
| Axis 單位對應 | 推理包中每個 endpoint → OpenAPI path/method 的具體對應 |
| 退出狀態 | Reason 步是否完整通過 |
slice_list | Planner 指定的切檔清單：每個 slice 的 target_path + scope（包含哪些 endpoint groups）。target_path 為 caller 提供之相對於 ${CONTRACTS_DIR} 的檔案路徑。target_path 內不得含 <<NN-functional-module>> 借位子層；${CONTRACTS_DIR} 在 SSOT 已是 flat directory（見 aibdd-core::ssot/spec-package-paths.md），functional module 借位只允許出現在 ${TRUTH_BOUNDARY_PACKAGES_DIR} 子樹。type 亦不出現於 path — 由 ${BOUNDARY_YML} type 欄位 SSOT。 |
缺項：推理包不完整或 slice_list 未指定 → 回退呼叫 Planner 補齊（白話文回報「推理包不完整」）。
references/format-reference.md（OpenAPI 3.x 語法合法範例、狀態碼、型別）references/patterns/command-resource.md（狀態遷移、命令封裝、讀模型、後端裁定邊界）references/patterns/anti-patterns.md（對照自查）common.api.ymlpatterns/rest-naming.md）patterns/error-schema.md、patterns/modular-layout.md$ref 引用target_path 不得含 <<NN-functional-module>> 借位子層；任一違反 → STOP 並回退 Planner 補正（白話文回報「target_path 違反 ${CONTRACTS_DIR} flat 規約」）。target_path 逐一寫出（落點＝${CONTRACTS_DIR} ⊕ target_path）。command-resource.md）。command-resource.md、anti-patterns.md）。patterns/rest-naming.md）POST（見 command-resource.md）<verb><Resource> camelCase（createOrder）；path 仍保持名詞導向ErrorResponse { message, code }（見 patterns/error-schema.md）common.api.yml#/components/schemas/ErrorResponsepatterns/modular-layout.md）$ref 引用語法嚴格遵循 OpenAPI 3.x 規範info.title 反映 scope以白話文 1–3 句匯報（依 aibdd-core::planner-contract.md §REPORT 匯報；不輸出 JSON / YAML）：
Form API Spec 完成。產出 N 個 OpenAPI 檔案。
responses 形狀、狀態碼對照、型別推斷ErrorResponse 與 4xx 分工$ref、slice info當要把一筆需求對齊進 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.