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。

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

RAPTor 規格調和修復。讀取 rapt-verify 報告，將問題分類為機械性（可自動修復）或語意性（需人工決策），對機械性問題直接修復，對語意性問題委派 rapt-clarify。Use when: /rapt-reconcile、rapt-verify 報告有 FAIL/PARTIAL、修復 SSoT 不一致。

RAPTor Phase 1.5 高階 Gherkin 生成。從 discovery 產出中萃取使用者故事，並生成業務語言的高階 Gherkin feature files（SSoT）。Use when: 完成 /rapt-discovery 後、/rapt-behavior、需要建立 BDD Feature 規格。

RAPTor Phase 3 釐清流程。掃描所有 SSoT 中的 CiC 便條（GAP/ASM/BDY/CON），打包成問題集，與使用者進行釐清 session，並將決策套用回 SSoT。Use when: 完成 /rapt-modeling 後、/rapt-clarify、有 CiC 便條需要處理、SSoT 中有疑問需要確認。

RAPTor Phase 1 業務探索。讀取現有需求文件、會議記錄、RFP 等 source，產出 discovery 摘要（stakeholders、journey、events、vision/KPI/scope）。Use when: 開始一個新需求分析、/rapt-discovery、需要整理業務背景資料。

RAPTor DBML Worker。僅由 rapt-modeling DELEGATE 呼叫，依 payload 渲染 annotated DBML v3.3 schema 檔案。不推斷、不填補 payload 以外內容。

RAPTor Gherkin Worker。僅由 rapt-behavior DELEGATE 呼叫，依 payload 渲染高階 Gherkin .feature 檔案。不推斷、不填補 payload 以外內容。

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

RAPTor haARM Worker。僅由 rapt-modeling 或 rapt-reconcile DELEGATE 呼叫，依 payload 渲染 haARM v3.3 YAML 檔案。不推斷、不填補 payload 以外內容。

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

RAPTor Phase 4 意圖規格制定。從 DBML + haARM + Gherkin 切分 API 意圖（haAPI）和頁面意圖（haPDL），生成意圖層 SSoT。Use when: 完成 /rapt-clarify 後、/rapt-intent、需要生成 haAPI/haPDL 規格。

RAPTor Phase 2 領域建模。從 discovery + Gherkin 產出建立 annotated DBML（資料模型 SSoT）與 haARM（存取控制 SSoT）。Use when: 完成 /rapt-behavior 後、/rapt-modeling、需要建立資料模型或 RBAC 規格。

RAPTor Phase 5 規格驗證。讀取所有 SSoT artifacts（DBML、haARM、Gherkin、haAPI、haPDL），執行完整性、一致性、可追蹤性、覆蓋率四項驗證，輸出驗證報告。Use when: /rapt-verify、需要驗證規格、Phase 5。

RAPTor 新功能與變更的事前影響分析。讀取 what-if 提案、行內需求或指定 SSoT 路徑，唯讀遍歷 DBML、haBDD、haARM、haAPI、haPDL 與 traceability，產出受影響 artifact、既有行為回歸風險、價值對齊、驗證計畫，以及 accept/defer/reject/needs_clarification 建議。Use when: /rapt-impact、brownfield 新功能加入前評估、scope-creep 裁決、clarify 選項可能改變 scope，或需要回答變更會牽動哪些規格。Advisory-only，不修改 SSoT 或 impact-matrix。

RAPTor 人工 SSoT 變更同步。偵測使用者直接修改的 SSoT artifact，產生 HSYNC 變更紀錄，透過既有 impact-matrix 工具登錄 manual_change，並建議接續 /rapt-verify。Use when: /rapt-human-sync、人工修改 SSoT 後、verify 前需要補齊人工變更追蹤。

RAPTor 專案初始化。建立 `.raptor/KICKOFF_PLAN.md`、`.raptor/arguments.yml`（路徑設定 SSoT）與 `.raptor/session.md`。Use when: 開始新專案需求分析、第一次在某個 repo 執行 RAPTor 流程、/rapt-kickoff、需要建立或重設路徑設定。