rapt-form-haapi

النجوم١١

التفرعات٠

آخر تحديث٢٢ يونيو ٢٠٢٦ في ٠١:٣٣

RAPTor haAPI 格式生成器（Worker）。僅由 rapt-intent DELEGATE 呼叫，負責依 haAPI v3.3 DSL 規格將 payload 渲染成 haAPI YAML 檔案。不推斷、不補充、不詢問使用者。

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

المصدر

chrisokchen

chrisokchen/rapt

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

مطوّرو البرمجياتمهن الحاسوب والرياضيات·SOC 15-1252

مستكشف الملفات

2 ملفات

SKILL.md

readonly

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"}

RAPTor Form haAPI — haAPI 格式生成器（Worker）

先遵守 rapt-core：

LOAD REF [rapt-core::planner-worker-contract.md]
LOAD REF [rapt-core::dsl-cross-reference-v33.md]
LOAD REF [rapt-form-haapi::references/haapi-format-anchor.md]

TRIGGER

Planner 透過 DELEGATE 傳入 payload 呼叫 rapt-form-haapi。
payload 含 target path、source evidence、dsl version 與 write mode。

SKIP

payload 缺少 target path 或 source evidence。
requested write path 超出 Artifact Output Contract。
需要推斷或補充 payload 以外內容才能完成的 DSL artifact。

PRINCIPLE: Artifact Output Contract（只寫 payload.output_file）

PRINCIPLE: Worker 禁止推斷、禁止 ASK、禁止補充 payload 外的內容

PRINCIPLE: STRICT SOP

Artifact Output Contract

操作	路徑	說明
CREATE / UPDATE	`payload.output_file`	haAPI YAML 檔案
DENY	任何其他路徑
DENY	推斷 payload 以外的 entity/resource
DENY	加入 payload 未指定的欄位
DENY	`access.permissions:`	deprecated，絕對禁止

SOP

步驟 0：ASSERT payload

ASSERT: payload.schema_version == "3.3"
ASSERT: payload.api_intent 非空
ASSERT: payload.source_evidence 非空
ASSERT: payload.output_file 路徑存在（目錄已建立）
若 ASSERT 失敗 → EMIT 錯誤訊息，停止

步驟 1：LOAD format anchor

LOAD REF [rapt-form-haapi::references/haapi-format-anchor.md]

步驟 2：RENDER haAPI YAML

依 haapi-format-anchor.md 的結構，將 payload 對映生成：

api: → 來自 payload.api_intent.api_id
schema_version: "3.3" → 固定值
entity: → 來自 payload.api_intent.entity（不修改大小寫）
title: → 來自 payload.api_intent.title
access.endpoints → 依 standard + operations 生成
access.operations → 每個 operation 附 required_roles / required_permissions
list: → 依 payload.api_intent.list 生成
cic_notes: → 僅包含 payload 傳入的 CiC notes

嚴格禁止：access.permissions:（不論任何情況）

步驟 3：WRITE 到 payload.output_file

WRITE 生成的 YAML 到 payload.output_file。

步驟 3.5：RUN dsl-lint（生成當下驗證，shift-left）⭐

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:。

步驟 4：EMIT 完成確認

✅ haAPI 已生成並通過 dsl-lint：{output_file}
entity: {entity}，operations: {N} 個

Worker Failure Contract

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 需執行的後續修正動作>

المزيد من هذا المستودع

نفس المستودع

rapt-core

chrisokchen/rapt

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。

2026-07-0511

rapt-clarify-loop

chrisokchen/rapt

RAPTor 釐清互動循環。僅由 rapt-clarify DELEGATE 呼叫，負責以格式化方式呈現問題集並等待使用者回應。是 skill 家族中主要的 ASK yield 執行者。

2026-07-0211

rapt-design-brief

chrisokchen/rapt

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。

2026-07-0211

rapt-lofi

chrisokchen/rapt

RAPTor Preview Tool：從 haPDL + annotated DBML + haARM 生成自包含的 Lo-Fi wireframe HTML，供開發者預覽頁面意圖。Use when: /rapt-lofi、預覽頁面、Lo-Fi wireframe。

2026-07-0211

rapt-openapi

chrisokchen/rapt

RAPTor Preview Tool：從 haAPI + haARM + annotated DBML 生成 OpenAPI 3.0.3 YAML，供 Swagger UI / Redocly 預覽 API 規格。Use when: /rapt-openapi、預覽 API、產生 OpenAPI spec。

2026-07-0211

rapt-rascore

chrisokchen/rapt

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 後品質評分。

2026-07-0211

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"}

RAPTor Form haAPI — haAPI 格式生成器（Worker）

先遵守 rapt-core：

LOAD REF [rapt-core::planner-worker-contract.md]
LOAD REF [rapt-core::dsl-cross-reference-v33.md]
LOAD REF [rapt-form-haapi::references/haapi-format-anchor.md]

TRIGGER

Planner 透過 DELEGATE 傳入 payload 呼叫 rapt-form-haapi。
payload 含 target path、source evidence、dsl version 與 write mode。

SKIP

payload 缺少 target path 或 source evidence。
requested write path 超出 Artifact Output Contract。
需要推斷或補充 payload 以外內容才能完成的 DSL artifact。

PRINCIPLE: Artifact Output Contract（只寫 payload.output_file）

PRINCIPLE: Worker 禁止推斷、禁止 ASK、禁止補充 payload 外的內容

PRINCIPLE: STRICT SOP

Artifact Output Contract

操作	路徑	說明
CREATE / UPDATE	`payload.output_file`	haAPI YAML 檔案
DENY	任何其他路徑
DENY	推斷 payload 以外的 entity/resource
DENY	加入 payload 未指定的欄位
DENY	`access.permissions:`	deprecated，絕對禁止

SOP

步驟 0：ASSERT payload

ASSERT: payload.schema_version == "3.3"
ASSERT: payload.api_intent 非空
ASSERT: payload.source_evidence 非空
ASSERT: payload.output_file 路徑存在（目錄已建立）
若 ASSERT 失敗 → EMIT 錯誤訊息，停止

步驟 1：LOAD format anchor

LOAD REF [rapt-form-haapi::references/haapi-format-anchor.md]

步驟 2：RENDER haAPI YAML

依 haapi-format-anchor.md 的結構，將 payload 對映生成：

api: → 來自 payload.api_intent.api_id
schema_version: "3.3" → 固定值
entity: → 來自 payload.api_intent.entity（不修改大小寫）
title: → 來自 payload.api_intent.title
access.endpoints → 依 standard + operations 生成
access.operations → 每個 operation 附 required_roles / required_permissions
list: → 依 payload.api_intent.list 生成
cic_notes: → 僅包含 payload 傳入的 CiC notes

嚴格禁止：access.permissions:（不論任何情況）

步驟 3：WRITE 到 payload.output_file

WRITE 生成的 YAML 到 payload.output_file。

步驟 3.5：RUN dsl-lint（生成當下驗證，shift-left）⭐

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:。

步驟 4：EMIT 完成確認

✅ haAPI 已生成並通過 dsl-lint：{output_file}
entity: {entity}，operations: {N} 個

Worker Failure Contract

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 需執行的後續修正動作>