技能介绍

先搞清楚你要解决的问题

当你手上有多个现成 skill，想把它们串成一个完整工作流时，真正的麻烦往往出现在交界处。最典型的痛点是接口错位：A skill 的输出是 JSON，B skill 却期望 CSV，导致拼装后无法直接运行。其次是状态丢失，工作流跑到第三步挂了，前两步的结果全丢，只能从头再来。此外，某个组件 skill 的 OAuth 过期或接口变更，也会让整条流水线瘫痪。单独调试每个 skill 没问题，但拼装之后出现的问题很难定位是哪个零件的锅。工作流Skill工厂就是用来处理这些组装、打包和排障工作的。

工厂是怎么运转的

整个流程分为四个环节，对应四项核心能力：

选件：先理解最终目标并拆解为能力单元，扫描本地已装 skill 优先复用，再从 skillhub 或 ClawHub 搜索补全缺失组件，输出包含必选和可替代项的方案。
接线：这是最关键的一步。需要读取每个 skill 的 SKILL.md，定义 data_flow 契约，逐项检查相邻两步的接口格式。如果存在 gap_warning，需提供 transform 转换逻辑或建议更换组件；同时给关键节点配置 fallback 降级方案，防止主 skill 挂掉导致流程死锁。
成包：基于 examples/my-workflow.template.yaml 生成标准目录结构。SKILL.md 里必须写明 pipeline 顺序、断点续跑规则和降级策略。打包时采用显式文件白名单，确保不会把 .env、tokens 或 __pycache__ 打进 zip。
排障：提供六层诊断树，从安装、依赖、配置一路查到数据流匹配和历史错误。发生中断时自动保存 .state/ 现场，支持从断点恢复。

适用边界与注意点

这个 skill 只做组装和诊断，绝不修改任何组件 skill 的源码。生成的工作流依赖 agent 按 SKILL.md 的描述来执行串联，而非硬编码的独立程序。打包发布时务必检查配置文件，API Key 只留占位符。它适合处理结构性的拼装问题；如果单个 skill 内部逻辑本身有 bug，仍需回到该 skill 的仓库去修复。