用途:创建或修订可用的 OMA 技能,明确路由、单一执行路径、领域恢复与适度上下文;也可审计或规范化 OMA 技能、其资源及 SSL-lite 格式,并判断内容应内联、放入条件资源还是删除。
适用场景:编写 .agents/skills/{name}/SKILL.md 及其配套资源;评审技能路由、执行契约、引用加载或重复指令。不适用于:安装第三方技能(用技能安装器)、创建 Codex 插件(用插件工具)、应用实现(对应领域专家)、项目需求(oma-pm)。
输入与输出:输入为技能用途、触发条件、边界、执行模型,以及需保留的既有命令/资源或用户修改;输出为四段式 SKILL.md、仅必要的配套资源,以及含未解决限制的校验结果。
依赖:resources/ssl-lite-template.md 提供骨架,resources/validation-checklist.md 提供验收标准;使用原生文件工具与可用的 oma 技能校验器,遵循仓库关于源归属与生成副本的规则。
结构流程:新技能先对比 1–3 个同类技能,再用模板;既有技能保留可用领域细节,只改请求范围;重复指令保留一处权威位置;长或条件细节移入具名资源并附加载条件;机器可校验产物按模板声明结构化输出。
失败恢复:路由过宽则收窄触发条件并补充具体的交叉路由“不适用”说明;执行模糊则补充实际对象、路径、命令参数与证据;多段重复流程只保留规范流程;必需工具不可用则用文档化回退,否则报告无法验证的结果;源与生成副本冲突时走仓库生成流程,不手改受保护定义。
规范工作流:读取目标、其引用资源与相关仓库规则,识别独立入口与运行时已注入内容;选择命令密集、判断密集或引用密集行为,仅在有信息增益处使用模板骨架与可选段;只写一次规范流程,保留精确命令/输出契约、失败机制、副作用与有害操作限制,删除泛化复述与冗余示例;资源在 References 下统一索引并附加载条件;运行 oma skill lint --skill <name> 与 git diff --check,若路由描述变更则运行 oma skill audit,并执行 resources/validation-checklist.md 中自动化 lint 未覆盖的内容检查;报告变更、检查与剩余限制,不得仅因删除重复文件就宣称减少 token 用量,须实测实际加载上下文。
护栏:保留 YAML name 与可用于路由的 description;保留 Scheduling、Structural Flow、Logical Operations、References 四个顶级标题;保留单一规范命令/工作流路径、Intent signature、适用/不适用、输入输出预期、失败恢复与相关影响/护栏;SKILL.md 正文保持在 500 行以内,配套资源按条件加载,不创建 README/变更日志/安装文档来解释技能;保留解析输出/模式示例,不规定装饰性报告布局或通用自审循环;批量数据用确定性工具处理并返回摘要/产物路径而非原始数据。用户数据与凭证不得作为技能示例;提交与发布需相应授权。
限制:资料未提供具体版本、价格、平台支持范围及除上述命令外的其他能力信息。