用途:创建、修订和校验 OMA 技能,使用源自 Scheduling-Structural-Logical 的 SSL-lite Markdown 结构,保持结果可读、可执行、可维护。
主要能力:新建 .agents/skills/{name}/SKILL.md;把现有技能规范化为 SSL-lite 格式;为执行密集型技能补充 Canonical command path 或 Canonical workflow path;审计技能是否可被路由、执行、校验与恢复逻辑使用;判断详细示例应内联还是放入 resources/。
使用方式:先读取 1-3 个同类现有技能,将技能分类为 command-heavy、workflow-heavy、judgment-heavy 或 reference-heavy,再依据 resources/ssl-lite-template.md 起草 SKILL.md,并内联一条 canonical path。长示例、供应商细节或可选协议移入 resources/。校验顶层标题、canonical path、frontmatter 与空白。编辑 description 后运行 oma skills audit,确认新措辞不与相邻技能冲突(TF-IDF 余弦 ≥60% 警告,≥75% 失败)。
适用场景:新增技能、更新既有 OMA 技能、补充执行路径、审计技能可用性、决定示例放置位置。
限制:不用于安装第三方技能到 $CODEX_HOME/skills(用 Codex 内置安装器);不用于创建 Codex 插件包;不用于编写与技能创作无关的项目计划;不直接编辑产品代码或基础设施。必须保留四个顶层章节:Scheduling、Structural Flow、Logical Operations、References。不得创建额外 README、changelog 或安装文档,不得覆盖无关用户编辑。未明确要求时不暂存或提交更改。