Skill 工作流封装
这是什么
一个 skill 不该只是 markdown 笔记。真正可用的 skill,至少要回答:
- 它解决什么问题
- 何时触发
- 不该何时触发
- 需要哪些输入
- 输出什么结果
- 适合内联执行还是隔离执行
这个 skill 讲的是:如何把一个工作流包装成 OpenClaw 里真正可用的技能。
在 OpenClaw 里何时使用
- 你想把一套操作步骤沉淀成 skill
- 你发现某类任务经常重复出现
- 你在整理本地 skills 目录
- 你想让 skill 更容易被正确命中
核心原则
- skill 是工作流包,不是宣传文案。
whenToUse要写触发语言,不要写空话。- listing 文本必须有预算。
- 复杂流程要考虑隔离执行。
- skill 调用语义要明确,不能只在回答里提到 skill 名字。
一个好 skill 至少应包含
- 名称
- 描述
- 适用场景
- 不适用场景
- 核心步骤
- 与当前工具链的映射
- 常见失败模式
- 可产出物
OpenClaw 里的实战建议
- 如果 skill 明显对应某类请求,描述里要把触发词写清楚。
- skill 列表中的描述要短,正文再展开。
- 对复杂任务,skill 应明确是否建议用
sessions_spawn隔离执行。 - skill 应说明会用哪些 OpenClaw 工具,而不是只讲概念。
- 多个相近 skill 要做边界区分,避免重叠命中。
常见失败模式
whenToUse太泛,什么都像它。- 描述太长,导致列表成本大于收益。
- skill 里全是理论,没有本地工具映射。
- 本该隔离执行的流程硬塞进主会话。
- 说“使用某 skill”,但实际没有真正执行对应工作流。
你可以产出的东西
- 一份 skill 模板
- 一份 skill 命名与触发规范
- 一份“内联执行 vs 隔离执行”的判定表