菜单
RAPTor haAPI 格式生成器（Worker）。僅由 rapt-intent DELEGATE 呼叫，負責依 haAPI v3.3 DSL 規格將 payload 渲染成 haAPI YAML 檔案。不推斷、不補充、不詢問使用者。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | rapt-form-haapi |
| description | RAPTor haAPI 格式生成器（Worker）。僅由 rapt-intent DELEGATE 呼叫，負責依 haAPI v3.3 DSL 規格將 payload 渲染成 haAPI YAML 檔案。不推斷、不補充、不詢問使用者。 |
| metadata | {"user-invocable":false,"source":"project-level","skill-type":"worker"} |
先遵守 rapt-core：
rapt-form-haapi。| 操作 | 路徑 | 說明 |
|---|---|---|
| CREATE / UPDATE | payload.output_file | haAPI YAML 檔案 |
| DENY | 任何其他路徑 | |
| DENY | 推斷 payload 以外的 entity/resource | |
| DENY | 加入 payload 未指定的欄位 | |
| DENY | access.permissions: | deprecated，絕對禁止 |
ASSERT: payload.schema_version == "3.3"
ASSERT: payload.api_intent 非空
ASSERT: payload.source_evidence 非空
ASSERT: payload.output_file 路徑存在（目錄已建立）
若 ASSERT 失敗 → EMIT 錯誤訊息，停止
LOAD REF [rapt-form-haapi::references/haapi-format-anchor.md]
依 haapi-format-anchor.md 的結構，將 payload 對映生成：
api: → 來自 payload.api_intent.api_idschema_version: "3.3" → 固定值entity: → 來自 payload.api_intent.entity（不修改大小寫）title: → 來自 payload.api_intent.titleaccess.endpoints → 依 standard + operations 生成access.operations → 每個 operation 附 required_roles / required_permissionslist: → 依 payload.api_intent.list 生成cic_notes: → 僅包含 payload 傳入的 CiC notes嚴格禁止：access.permissions:（不論任何情況）
WRITE 生成的 YAML 到 payload.output_file。
RUN: python {rapt-verify::references/dsl-lint.py} --file {payload.output_file} --levels 1,2,3
若出現任何 ERROR（HAAPI-SCHEMA-* / HAAPI-LINT-* / DSL-PARSE-*）：
→ 依 lint 的 fix 指引修正 YAML，重新 WRITE，再次 RUN
→ 直到 0 ERROR 才進入步驟 4（禁止帶著漂移輸出）
重點：access.endpoints / access.operations 必為 dict（key=操作名）；path/method 只在 exposes；禁止頂層 endpoints:、禁止 access.permissions:。
✅ haAPI 已生成並通過 dsl-lint：{output_file}
entity: {entity}，operations: {N} 個
Worker 遇到下列任一情況時，不得產生任何檔案，必須立即回傳結構化的失敗結果。
worker_result:
status: failed
failure_kind: invalid_payload | missing_evidence | contract_violation | dsl_lint_failed | unsupported_case
target_path: <payload.target_path>
message: <失敗原因>
required_action: <Planner 需執行的後續修正動作>
RAPTor skill family 的共用 Reference Hub。Use when: 任何 rapt-* skill 需要載入共同原則、路徑與 arguments.yml 規則、SSoT 定義、Planner/Worker 合約、finding taxonomy、impact matrix、clarify payload、DSL cross-reference、phase gates 或 prompt migration map。
RAPTor 釐清互動循環。僅由 rapt-clarify DELEGATE 呼叫，負責以格式化方式呈現問題集並等待使用者回應。是 skill 家族中主要的 ASK yield 執行者。
RAPTor Preview Tool：從 haPDL + annotated DBML + haARM 生成結構化 Design Brief markdown，供 Claude Design 或 AI 設計工具直接生成 Hi-Fi UI。Use when: /rapt-design-brief、設計稿、Design Brief、Claude Design。
RAPTor Preview Tool：從 haPDL + annotated DBML + haARM 生成自包含的 Lo-Fi wireframe HTML，供開發者預覽頁面意圖。Use when: /rapt-lofi、預覽頁面、Lo-Fi wireframe。
RAPTor Preview Tool：從 haAPI + haARM + annotated DBML 生成 OpenAPI 3.0.3 YAML，供 Swagger UI / Redocly 預覽 API 規格。Use when: /rapt-openapi、預覽 API、產生 OpenAPI spec。
RAPTor RAscore 需求分析品質評分。讀取 discovery、Gherkin、DBML、glossary、traceability 與 verify report，以 LLM-assisted rubric 產生 advisory-only RAscore、veto、scorecard 與 findings。Use when: /rapt-RAscore、需要評估 Gherkin + DBML 是否可作為 SSoT、Phase 2 後品質評分。