Object spec:CLAUDE.md/skill 檔案

Object: CLAUDE.md 與 .claude/skills/*/SKILL.md

適用範圍:規範這兩類檔案「新增或修改規則」時的寫法本身。不規範它們描述的 DragonsHoard 業務規則內容對不對,只管怎麼寫。

規格本體

新增或修改規則時,遵守以下原則:

  1. 可執行:觸發條件應能明確判斷,不依賴 AI 自行猜測是否適用;執行結果應可驗證。
  2. 只寫行為:只描述「要做什麼」;設計理由、事故經過與理論說明放在對應文件,必要時僅保留連結。
  3. 判準明確:多步驟或條件式規則應明確定義條件與動作;分支盡量互斥且完整,避免抽象或需要額外推論的描述。
  4. 保持扁平:優先使用直接的「條件 → 動作」敘述;簡稱只定義一次,例子只作補充,不取代正式判準。

驗證方式

需要語意判斷(是否夠「可執行」、是否混了理由進規則本身),不可自動化。