062、编写自定义 Skill：SKILL.md 规范、触发词设计与发布流程
062、编写自定义 Skill：SKILL.md 规范、触发词设计与发布流程
昨天半夜被一个线上问题折腾到三点——自定义 Skill 在 CodeX 里死活不触发，日志里连个影子都没有。我盯着 SKILL.md 看了半小时，最后发现是触发词里多了一个不可见的零宽空格。这种坑，踩过一次就记住了。今天这篇笔记，就把我写自定义 Skill 时积累的规范、触发词设计套路和发布流程，原原本本摊开来说。
一、SKILL.md 文件结构：别被 YAML 头骗了
CodeX 的 Skill 定义文件叫 SKILL.md，放在~/.codex/skills/目录下（或者项目根目录的.codex/skills/）。很多人以为这就是个普通 Markdown，其实它的灵魂在 YAML 头。
---name:"git-commit-helper"version:"1.0