技能創作者

技能創作者 是做什麼的？

工作流程

1. 建立合約。

   • 讀取現有技能與其資源，或收集對新技能的具體需求。
   • 從同義分支中區分實際的工作流程分支。
   • 完成條件： 每個分支都有具體的觸發條件、預期結果與持久化目標。

2. 選擇調用方式。

   • 模型可探索：撰寫面向模型的 description；省略 disable-model-invocation。
   • 僅限手動：設定 disable-model-invocation: true；撰寫面向人類的摘要。
   • 直接指令工具：僅在指令繞過模型時，加入 command-dispatch: tool、command-tool 與 command-arg-mode。
   • 完成條件： 前端資料與技能實際被調用的方式相符。

3. 組織技能結構。

   • 將共享的順序程序對應到 SKILL.md；每個步驟結束時加上可檢查的完成標準，並以驗證收尾。
   • 將路由條件保留在 description 中；從執行開始撰寫主體。
   • 將僅限分支的細節對應到 references/、可重複使用的輔助工具對應到 scripts/、輸出資源對應到 assets/、以及可選的 UI 元資料對應到 agents/。
   • 完成條件： 每個規劃的資源都有單一用途，並能從 SKILL.md 直接指向。

4. 草擬與保留。

   • 即時工作區技能：使用 skill_workshop 建立或修改待審提案；在套用前保持現有檔案不變。
   • 儲存庫擁有的技能來源：使用該儲存庫的一般編輯與審查流程。
   • 完成條件： 提案或來源差異實作了第一步驟的每個分支，並包含第三步驟的每個資源。

5. 驗證。

   • 執行 python {baseDir}/scripts/quick_validate.py <技能目錄> 並執行每個被觸及的輔助工具的專注測試。
   • 完成條件： 前端資料通過驗證、資源指標能夠解析，且每個被觸及的輔助工具通過其專注測試。

前端資料

必填：name、description。

OpenClaw 也支援 metadata、homepage、license、allowed-tools、user-invocable、disable-model-invocation、command-dispatch、command-tool 與 command-arg-mode。僅在這些選用欄位會影響執行時行為或可發現性時才加入。