name: skill-sub
version: 1.24.1
author: wUwproject
license: MIT
description: 调用链编排技能 — 既是调用链编辑器，也是粗粒度规划器。理解用户意图 → 规划 Skill 参与顺序 → 更新/保存/推荐调用链 → 拼接为调用链（支持循环/分支编排、子步骤拓扑排序、准确步骤计数）。
sensitive_access: false
critical_write: false
permission_weight: LOW
data_dir: ../.standardization/skill-sub/data/
tags: ['chain', 'orchestration', 'usable', 'skill-builder', 'progressive-loading', 'planner', 'editor']
externaldatadir: true
trigger: ['规划类: 帮我规划一下/步骤是什么', '顺序类: 依次执行/先...再...', '链管理: 创建/查看/更新/删除调用链']
trigger_negative: ['不使用调用链', '手动逐步执行']

skill-sub

反模式详见 references/antipatterns.md

触发场景

当用户提出以下意图时触发本技能：

• 规划类：「帮我规划一下...」、「...的步骤是什么」
• 顺序类：「依次执行 A、B、C」、「先...再...」
• 链管理：「创建/查看/更新/删除调用链」

否定条件：仅当用户明确要求「不使用调用链」或「手动逐步执行」时，不自动触发。

核心能力

📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。

| # | 功能 | 说明 |
|---|------|------|
| 1 | 调用链管理 | 创建、查询、更新、删除调用链 |
| 2 | 执行计划生成 | 生成结构化执行计划，含并行/串行标记 |
| 3 | 条件执行 | 支持条件步骤，按条件判断是否执行 |
| 4 | 循环与分支编排 | 支持 for-each/while 循环和 if-else 分支 |
| 5 | Dry-Run 模式 | 模拟执行，不实际调用技能 |
| 6 | 链备份与版本管理 | 自动备份，支持版本恢复 |

工作流程

1. 理解意图 → 分析用户输入，判断是否需要调用链
2. 规划技能顺序 → 推荐参与的 Skill 及其顺序
3. 生成调用链 → 创建 JSON 格式的调用链定义
4. 生成执行计划 → 输出 AI 可直接执行的指令序列
5. （可选）实际执行 → 按执行计划逐步调用技能

快速开始

# 初始化
python {SKILL_DIR}/scripts/chain_manager.py init

# 创建调用链
python {SKILL_DIR}/scripts/chain_manager.py create --name "发布流水线" --description "技能发布流程" --purpose "一键发布" --steps '[...]'

# 生成执行计划（含执行预览）
python {SKILL_DIR}/scripts/chain_executor.py plan --name "发布流水线" --verbose

# Dry-Run 模拟执行（不实际调用技能）
python {SKILL_DIR}/scripts/chain_executor.py plan --name "发布流水线" --dry-run

# 查看调用链
python {SKILL_DIR}/scripts/chain_manager.py show --name "发布流水线"

# 列出所有调用链
python {SKILL_DIR}/scripts/chain_manager.py list

# 删除（自动备份）
python {SKILL_DIR}/scripts/chain_manager.py delete --name "发布流水线" --force
```text

---

## 循环与分支编排（v1.20.0 新增）

### for-each 循环

在调用链 JSON 中，将某步骤的 `type` 设为 `"loop"`，并定义 `loop` 对象：

```json
{
  "type": "loop",
  "step_name": "批量处理文件",
  "loop": {
    "mode": "for_each",
    "items": "{{file_list}}",
    "loop_variable": "f",
    "max_iterations": 10,
    "steps": [
      {"type": "skill", "skill_name": "file-ops", "step_name": "处理单个文件", "action": "处理 {{f}}"}
    ]
  }
}
```text

### while 循环

```json
{
  "type": "loop",
  "step_name": "重试直到成功",
  "loop": {
    "mode": "while",
    "while_condition": "{{retry_count}} < 3 and {{last_result}} != 'success'",
    "max_iterations": 3,
    "steps": [
      {"type": "skill", "skill_name": "api-call", "step_name": "调用接口", "action": "重试第 {{retry_count}} 次"}
    ]
  }
}
```text

### if-else 分支

```json
{
  "type": "branch",
  "step_name": "按环境部署",
  "branch": {
    "condition": "{{env}} == 'prod'",
    "if_steps": [
      {"type": "skill", "skill_name": "deploy", "step_name": "生产部署", "action": "部署到生产环境"}
    ],
    "else_steps": [
      {"type": "skill", "skill_name": "deploy", "step_name": "预发部署", "action": "部署到预发环境"}
    ]
  }
}

📚 完整 schema 详见 references/chain_schema.md

详细文档

完整工作流程、使用示例、反模式与常见问题 → 见 references/ 目录：

• references/workflow.md — 详细工作流程
• references/examples.md — 使用示例
• references/faq.md — 常见问题与反模式
• references/chain_schema.md — 调用链数据结构定义
• references/permissions.md — 权限说明

配置

配置界面：python {SKILL_DIR}/scripts/settings.py

| 配置项 | 选项 | 说明 |
|--------|------|------|
| 记忆参考 | 是 / 否 | 创建/执行调用链时，是否读取用户记忆文件增强步骤描述 |
| 命名方式 | 自动 / 人工 | 创建调用链时，由 AI 自动命名还是询问用户 |
| 默认重试次数 | 1-10（默认3） | 所有步骤的默认最大重试次数 |