Codex Plugin-Dev：Validation（Skill 觸發/格式）

核心檢查項

1. SKILL.md frontmatter 是否存在且可解析
2. name 是否符合 ^[a-z0-9-]+$，且與資料夾名一致
3. description 是否以 Use when... 開頭
4. description 是否包含足夠關鍵字/同義詞（可被命中）
5. Supporting files 路徑是否存在、指令是否可執行

快速驗證（腳本）

• pwsh -File C:\\Users\\IOT\\.codex\\skills\\codex-plugin-dev-validate\\scripts\\validate_codex_skill.ps1 -SkillName <skill-name>

若環境有設定 $env:CODEX_HOME，腳本會優先在 $env:CODEX_HOME\\skills\\... 找 skill。

當「沒觸發」時的 Debug 問題

• 使用者實際問法是什麼？（請貼 3～5 句原話）
• 你的 description 有沒有包含那些用詞？（同義詞也算）
• 有沒有更「精準」的 skill 在搶匹配？（描述重疊）