技能创建器

技能创建器 是做什么的？

工作流

1. 建立合约。

   • 读取现有技能及其资源，或收集新技能的具体需求。
   • 将实际工作流分支与同一分支的同义词区分开。
   • 完成条件： 每个分支都有具体的触发条件、预期结果和持久化目标。

2. 选择调用方式。

   • 模型可发现：编写面向模型的 description；省略 disable-model-invocation。
   • 仅手动调用：设置 disable-model-invocation: true；编写面向人类的摘要。
   • 直接工具命令：仅当命令绕过模型时，添加 command-dispatch: tool、command-tool 和 command-arg-mode。
   • 完成条件： 前导 YAML 头与实际调用方式匹配。

3. 结构化技能。

   • 将共享的有序流程映射到 SKILL.md；每一步以可检查的完成标准结束，最后进行验证。
   • 将路由条件保留在 description 中；正文从执行开始。
   • 仅属于分支的细节映射到 references/，可复用的辅助工具映射到 scripts/，输出资源映射到 assets/，可选的 UI 元数据映射到 agents/。
   • 完成条件： 每个计划中的资源都有一个用途，并且能从 SKILL.md 直接引用。

4. 草稿与持久化。

   • 活动工作区技能：使用 skill_workshop 创建或修改待处理的提案；在应用前保持活动文件不变。
   • 仓库持有的技能源：使用仓库常规的编辑和审查工作流。
   • 完成条件： 提案或源差异实现了步骤 1 中的每个分支，并包含步骤 3 中的每个资源。

5. 验证。

   • 运行 python {baseDir}/scripts/quick_validate.py <skill-directory> 并执行每个涉及的辅助工具的针对性测试。
   • 完成条件： 前导 YAML 头通过验证，资源指针解析正确，且每个涉及的辅助工具均通过针对性测试。

前导 YAML 头

必需字段：name、description。

OpenClaw 还支持 metadata、homepage、license、allowed-tools、user-invocable、disable-model-invocation、command-dispatch、command-tool 和 command-arg-mode。仅在可选字段改变运行时行为或发现方式时添加它们。