| name | aibdd-form-sequence-diagram |
| description | 將推理包翻譯為 Mermaid `sequenceDiagram` 檔（`.sequence.mmd`）。 目標路徑與單一 implementation path 內容由呼叫方透過 DELEGATE 參數指定，本 skill 不自決。
|
| metadata | {"user-invocable":false} |
aibdd-form-sequence-diagram
Formulation skill。把呼叫方傳來的推理包翻成 .sequence.mmd，再用 scripts/evaluate.py 驗語法。
§1 範例 — 產出檔長相
sequenceDiagram
actor Player
participant RoomController
participant JoinUseCase
participant RoomRepo
Player ->> RoomController: POST /rooms/join
RoomController ->> JoinUseCase: execute(cmd)
JoinUseCase ->> RoomRepo: upsertRoom()
Note right of RoomRepo: state: rooms.insert
JoinUseCase -->> RoomController: RoomJoined
RoomController -->> Player: 201 Created
Note over Player: ✓ HTTP 201 with body.room_id
支援的行類別（出現在上方範例中）：
- 觸發者：
actor <名稱>
- 內部協作者：
participant <名稱>
- 訊息：
<發送方> <箭頭> <接收方>: <說明>，箭頭可用 ->、->>、-->、-->>
- 狀態變更標註：
Note right of <擁有者>: state: <資料表>.<操作>
- 驗收標註：
Note over <觸發者>: ✓ <驗收條件>
僅支援上列五種行；不畫 loop / alt / opt / activate 等控制流區塊。
§2 SOP
Phase 1 — 收件
- 載入呼叫方傳入的內容。
- 確認輸出路徑以
.sequence.mmd 結尾。
- 不符 → 回傳「payload incomplete」並終止。
Phase 2 — 渲染
依 §1 五種行模板，把推理包逐項翻成 Mermaid 文字。
Phase 3 — 寫檔
- 若輸出路徑已存在且呼叫方未指定覆寫 → 回傳「path conflict」。
- 否則寫入該路徑。
Phase 4 — 驗證
- 對寫出的檔執行
python3 scripts/evaluate.py <剛寫的檔>。
- 解析 stdout JSON。
- 結果非通過 → 將驗證報告原樣回傳（含行號與訊息）並終止。
Phase 5 — 回報
回傳「狀態、輸出路徑、驗證報告」三項給呼叫方。
