激活合約
當需要審核、重構、規範化或改進現有的 SKILL.md 檔案時,請使用此技能。當要從可重複使用的模式建立全新的技能時,請使用 gentle-ai-skill-creator。
硬性規則
- 首先閱讀
docs/skill-style-guide.md,並將其視為規範性樣式合約。 - 將
SKILL.md視為事實來源;保留作者意圖、關鍵規則、激活語意與輸出要求。 - 使用
.atl/skill-registry.md作為技能名稱、觸發條件、範圍及確切路徑的索引(若有的話)。 - 預設僅進行審計。只有當使用者明確要求套用改善時,才修改檔案。
- 切勿悄無聲息地刪除有意義的內容;將冗長的說明、範例、模板或結構定義移至本地的
references/或assets/目錄中。 - 不要憑空發明觸發條件、政策或領域規則。將模糊不清的情況標記為待人工審查。
決策閘門
| 情況 | 動作 |
|---|---|
| 前後文遺失或無效 | 修正 name、附引號的單行 description、license 及 metadata |
| 技能讀起來像教學文件 | 轉換為執行時指令,並將背景資料移至 references/ |
| 內容超出預算 | 保留規則,將範例/背景移至輔助檔案 |
| 分支邏輯隱藏在文字中 | 轉換為精簡的決策表 |
| 規則衝突或意圖不明 | 回報問題;不要自動重寫該條規則 |
執行步驟
- 讀取
docs/skill-style-guide.md。 - 讀取
.atl/skill-registry.md;使用列出的路徑選取技能。若路徑缺失,則掃描已知的技能目錄尋找*/SKILL.md。 - 對於每個選取的技能,審計其後設資料、觸發條件清晰度、章節順序、內容預算、可操作性、決策閘門、輸出合約及本地參考。
- 回傳一份按技能分組的審計報告,標註嚴重程度及確切的建議變更。
- 在套用模式下,僅編輯安全問題,保留內容,必要時建立輔助檔案,然後重新整理或請求
/skill-registry:refresh。
輸出合約
回傳:
- 已審計的技能及使用的路徑。
- 發現的問題,按嚴重程度分組。
- 若請求了套用模式,則列出已變更的檔案。
- 當技能後設資料或路徑變更時,給出註冊表重新整理的建議。
- 需要人工審查的模糊之處。
參考資料
docs/skill-style-guide.md— 規範性的 LLM-first 技能風格指南。skills/skill-registry/SKILL.md— 註冊表重新整理與索引合約。