foliko 2.0.6 → 2.0.7

package/skills/workflows/workflow-troubleshooting/SKILL.md

@@ -1,331 +0,0 @@
----
-name: workflow-troubleshooting
-description: 工作流故障排除与修复指南。当工作流执行失败、工具调用失败、模板变量问题时调用此技能。
-allowed-tools: python-executor, shell, read_file, write_file, execute_workflow, workflow_reload
----
-
-# 工作流故障排除指南
-
-## 常见问题与解决方案
-
-### 1. Unknown step type 错误
-
-**原因**：使用了不支持的步骤类型，如 `action: "ext_call"`
-
-**解决方案**：使用 `type: "tool"` + `tool: "ext_call"` 调用扩展工具
-
-```json
-// ❌ 错误
-{ "action": "ext_call", "params": { ... } }
-
-// ✅ 正确
-{
-  "type": "tool",
-  "tool": "ext_call",
-  "args": {
-    "plugin": "skill",
-    "tool": "creator:creator",
-    "args": { "command": "-r 16:9" }
-  }
-}
-```
-
-### 2. 工具参数问题：args vs params
-
-**原因**：工作流引擎使用 `args` 字段传递工具参数，不是 `params`
-
-**解决方案**：
-
-```json
-// ❌ 错误
-{ "type": "tool", "tool": "fetch", "params": { "url": "https://..." } }
-
-// ✅ 正确
-{ "type": "tool", "tool": "fetch", "args": { "url": "https://..." } }
-```
-
-### 3. loop 循环语法错误
-
-**正确语法**：
-
-**固定次数循环**：
-```json
-{
-  "type": "loop",
-  "maxIterations": 10,
-  "loopVariable": "i",
-  "steps": [...]
-}
-```
-
-**数组迭代循环（over）**：
-```json
-{
-  "type": "loop",
-  "over": "input.slides",
-  "as": "slide",
-  "index": "slideIndex",
-  "maxIterations": 10,
-  "steps": [...]
-}
-```
-
-- `over`: 要迭代的数组路径
-- `as`: 每个元素的变量名
-- `index`: 索引变量名（从 0 开始）
-
-- `maxIterations`: 最大迭代次数（必填）
-- `loopVariable`: 循环计数器变量名（默认 `loopIndex`）
-- `steps`: 循环执行的步骤数组
-
-### 4. condition 条件语法错误
-
-**原因**：使用了不存在的字段如 `if`、`then`
-
-**正确语法**：
-
-```json
-{
-  "type": "condition",
-  "branches": [
-    {
-      "name": "条件1",
-      "condition": "context.variables.value > 10",
-      "steps": [...]
-    }
-  ],
-  "defaultBranch": {
-    "steps": [...]
-  }
-}
-```
-
-- `condition`: JavaScript 表达式字符串
-- `branches`: 条件分支数组
-- `defaultBranch`: 默认分支（可选）
-
-### 5. switch 分支语法错误
-
-**正确语法**：
-
-```json
-{
-  "type": "switch",
-  "value": "{{status}}",
-  "branches": [
-    { "case": "success", "steps": [...] },
-    { "case": "error", "steps": [...] }
-  ],
-  "default": { "steps": [...] }
-}
-```
-
-- `value`: 要匹配的值，支持 `{{variable}}` 引用
-- `branches`: 分支数组，匹配 `case` 等于 `value` 的分支
-- `default`: 默认分支
-
-### 6. try-catch 语法错误
-
-**正确语法**：
-
-```json
-{
-  "type": "try",
-  "try": {
-    "steps": [
-      { "type": "tool", "tool": "可能失败的工具", "args": {} }
-    ]
-  },
-  "catch": {
-    "steps": [...]
-  }
-}
-```
-
-### 7. parallel 并行执行语法
-
-**正确语法**：
-
-```json
-{
-  "type": "parallel",
-  "steps": [
-    { "type": "tool", "tool": "task1", "args": {} },
-    { "type": "tool", "tool": "task2", "args": {} }
-  ]
-}
-```
-
-## 调试技巧
-
-### 1. 先单独测试每个步骤
-
-创建简单的单步骤工作流验证工具是否可用：
-
-```json
-{
-  "name": "test-tool",
-  "steps": [
-    {
-      "type": "tool",
-      "name": "测试",
-      "tool": "notification_send",
-      "args": { "message": "测试消息" }
-    }
-  ]
-}
-```
-
-### 2. 使用 script 步骤调试变量
-
-```json
-{
-  "type": "script",
-  "name": "调试变量",
-  "outputVariable": "debug",
-  "script": "return JSON.stringify(context.variables, null, 2);"
-}
-```
-
-### 3. 检查工具是否存在
-
-使用 `workflow_list` 工具查看所有已注册的工作流工具。
-
-### 4. 变量引用格式
-
-| 格式 | 说明 |
-| ---- | ---- |
-| `{{result}}` | 上一步完整结果 |
-| `{{result.field}}` | 从结果提取字段 |
-| `{{lastResult}}` | result 的别名 |
-| `{{variables.x}}` | 显式引用 variables |
-| `{{input.x}}` | 引用工作流输入 |
-| `${stepId.output}` | 引用指定步骤输出（兼容旧格式） |
-
-## 完整工作流示例
-
-### 示例：使用 ext_call 调用 skill 命令
-
-```json
-{
-  "name": "video-creator",
-  "description": "视频创作工作流示例",
-  "input": {
-    "title": "测试视频",
-    "slides": ["slide1", "slide2"]
-  },
-  "steps": [
-    {
-      "type": "tool",
-      "name": "创建项目",
-      "tool": "ext_call",
-      "args": {
-        "plugin": "skill",
-        "tool": "creator:creator",
-        "args": {
-          "command": "-r 16:9 -t true -v female-shaonv-jingpin"
-        }
-      },
-      "outputVariable": "videoId"
-    },
-    {
-      "type": "tool",
-      "name": "添加片头",
-      "tool": "ext_call",
-      "args": {
-        "plugin": "skill",
-        "tool": "creator:addCover",
-        "args": {
-          "command": "-i {{videoId}} -t '{{input.title}}'"
-        }
-      }
-    },
-    {
-      "type": "loop",
-      "name": "添加幻灯片",
-      "maxIterations": 10,
-      "loopVariable": "i",
-      "steps": [
-        {
-          "type": "condition",
-          "name": "检查是否还有幻灯片",
-          "branches": [
-            {
-              "name": "有幻灯片",
-              "condition": "context.variables.i < context.input.slides.length",
-              "steps": [
-                {
-                  "type": "tool",
-                  "name": "添加幻灯片",
-                  "tool": "ext_call",
-                  "args": {
-                    "plugin": "skill",
-                    "tool": "creator:addSlide",
-                    "args": {
-                      "command": "-i {{videoId}} -n {{i}}"
-                    }
-                  }
-                }
-              ]
-            }
-          ]
-        }
-      ]
-    },
-    {
-      "type": "tool",
-      "name": "渲染视频",
-      "tool": "ext_call",
-      "args": {
-        "plugin": "skill",
-        "tool": "creator:render",
-        "args": {
-          "command": "-i {{videoId}} -o output.mp4"
-        }
-      }
-    }
-  ]
-}
-```
-
-## 快速修复清单
-
-| 问题 | 修复 |
-| ---- | ---- |
-| `Unknown step type: ext_call` | 改用 `type: "tool"` + `tool: "ext_call"` |
-| 工具参数不传递 | 将 `params` 改为 `args` |
-| loop 不执行 | 检查 `maxIterations` 和 `steps` 字段 |
-| condition 不生效 | 使用 `condition` 字段，不是 `if` |
-| switch 不匹配 | 确保有 `default` 分支兜底 |
-| 变量引用失败 | 使用 `{{result}}` 而非 `${result}` |
-
-## 成功案例
-
-### 视频创作工作流（已验证）
-
-```json
-{
-  "name": "hot-news-video",
-  "steps": [
-    {
-      "type": "tool",
-      "tool": "ext_call",
-      "args": {
-        "plugin": "skill",
-        "tool": "creator:creator",
-        "args": { "command": "-r 16:9 -t true -v female-shaonv-jingpin" }
-      },
-      "outputVariable": "videoId"
-    },
-    {
-      "type": "tool",
-      "tool": "ext_call",
-      "args": {
-        "plugin": "skill",
-        "tool": "creator:addCover",
-        "args": { "command": "-i {{videoId}} -t '{{input.title}}'" }
-      }
-    }
-  ]
-}
-```