编程

skill-sub

试用

调用链编排技能 — 既是调用链编辑器,也是粗粒度规划器。理解用户意图 → 规划 Skill 参与顺序 → 更新/保存/推荐调用链 → 拼接为调用链(支持循环/分支编排、子步骤拓扑排序、准确步骤计数)。

它能做什么

调用链编排技能 — 既是调用链编辑器,也是粗粒度规划器。理解用户意图 → 规划 Skill 参与顺序 → 更新/保存/推荐调用链 → 拼接为调用链(支持循环/分支编排、子步骤拓扑排序、准确步骤计数)。

技能文档

skill-sub

约束

参数约束:skill-dir 绝对路径 20-260 字符,描述文本 ≤120 字。最大步骤数 30 层,粘连点占比上限 30%,依赖深度上限 10 层。

适宜场景 ✅

场景说明
多 skill 编排涉及 2 个及以上 skill,步骤间有明确依赖关系
可固化流程流程稳定、可复现,不是一次性操作
跨步骤衔接skill 之间需要数据转换、人工审批、流程补全

不适宜场景 ❌

场景原因
单 skill 任务直接调 skill 本身即可,不需要调用链
一次性操作调用链的价值在于复用,一次性工作不值得建链
无依赖的并行任务多个独立任务应并行执行,不需要编排
高度动态的流程每次执行步骤都不一样,粘连点也解决不了,直接 AI 手动处理

硬限制

限制项说明
最大步骤数30 层(含嵌套)超过后校验器会告警,但不阻断执行
粘连点占比30%超过告警,建议合并或补充 skill
粘连点连续禁止连续缺口合并为一个粘连点
依赖深度10 层过深依赖链难以维护和排查
循环最大迭代默认 10,可配置超过按 on_max_iteration 处理

常见创建错误速查

报错信息原因解决方法
连续缺口应合并为一个粘连点两个 adhesion 步骤相邻合并为一个 adhesion,用 hybrid 方案覆盖全部缺口
粘连点占比超过 30%adhesion 步骤太多检查是否有 skill 可以替代
缺少 solutionsadhesion 步骤没有提供方案至少加一个 manual 方案
依赖不存在的步骤depends_on 引用了无效索引检查依赖步骤的 index 是否正确
引用的 skill 不存在skill_name 对应的 skill 未安装检查 skill 名称是否正确
检测到定时/自动化意图,但未提供 --schedule描述中含"每天/每周/定时"等词但没给调度配置添加 --schedule 参数,或删除描述中的时间相关词

强制规则:用户描述中包含定时/自动化意图(如"每天"、"每周"、"自动执行"等)时,必须提供 --schedule 参数配置调度信息,否则链创建被拦截。 不依赖 AI 自觉判断。

触发条件

正向触发:

  • 规划类:「帮我规划一下...」、「...的步骤是什么」
  • 顺序类:「依次执行 A、B、C」、「先...再...」
  • 链管理:「创建/查看/更新/删除调用链」
  • 步骤搜索类:「搜索步骤」、「找步骤」
  • 链健康检查:「检查链的健康状态」
  • 仅涉及单个 skill 的简单任务

否定条件:

  • 明确要求「不使用调用链」

触发场景

正向触发

  • chain_executor.py - Chain Executor v1.22.0
  • 调用链执行引擎:根据调用链定义生成结构化执行计划,
  • 识别依赖关系、并行机会,输出 AI 可执行的指令序列。
  • 加载用户配置(合并默认值 + 用户覆盖)

否定条件

  • 简单问答、闲聊、问候(不需要本技能)
  • 单步任务(不需要结构化执行)

核心能力

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

#功能说明
1调用链管理创建、查询、更新、删除调用链
2执行计划生成生成结构化执行计划,含并行/串行标记
3条件执行支持条件步骤,按条件判断是否执行
4循环与分支编排支持 for-each/while 循环和 if-else 分支
5门禁系统10 座 HARD 门禁串行阻断管线(chain_gate.py),HOOK-BLOCK 输出
6步骤蓝皮书过期检测search 命令前置自动比对指纹,过期直接拒绝搜索
7链私有蓝皮书基线校验链创建时 snapshot 步骤接口,执行前自动校验基线偏移
8粘连点(Adhesion Point)标记 skill 无法自动化的缺口,提供三种解决方案保证链不断
9自增强闭环(模板搜索)chain_manager search 匹配历史链,相似意图直接复用

渐进式文件索引

文件名分类包含内容审计关联
references/LICENSE.md许可协议开源许可证声明(MIT)。包含:MIT 许可证完整文本。R-26
references/adhesion.md参考文档> v1.25.0 新增。粘连点是调用链中无法由 skill 自动化的缺口标记。
references/antipatterns.md规范指南skill 编写中的常见反模式。包含:错误做法示例、正确做法示例、避坑指引。R-18
references/chain_schema.md参考文档> 本文档定义 Chain / Step / retry_policy / failure_mode 的完整结构。
references/changelog.md版本管理版本更新日志。包含:版本号、更新类型、修复项、升级说明。R-24
references/examples.md使用示例各场景完整执行示例。包含:CLI 命令、执行过程、输出结果。R-25 C-17
references/faq.md常见问题常见疑问与解答。包含:问题分类、原因分析、解决方案。R-19, R-25 C-19
references/loop_branch.md参考文档> 本文档是 SKILL.md 的渐进式补充,包含循环与分支编排的完整示例。
references/permissions.md权限与测试权限扫描说明与测试结论。包含:风险等级、高权限操作说明、测试概览、计时统计。R-15, R-16
references/reference.md命令参考CLI 完整命令参考。包含:所有参数、子命令、选项、示例用法。
references/workflow.md参考文档> 本文档是 SKILL.md 的渐进式补充,详细描述执行流程、里程碑判断规则、三层回退策略。
references/blueprint.md参考文档步骤蓝皮书结构与更新流程
references/gate.md参考文档门禁系统完整文档与 CLI 示例
references/private_blueprint.md参考文档链私有蓝皮书基线保护机制
references/llm_params.md参考文档LLM 参数格式与门禁对应关系
references/chain_search.md参考文档自增强闭环历史链搜索

快速开始

#功能说明
1调用链管理创建/查询/更新/删除
2门禁系统10 座 HARD 门禁
3蓝皮书过期检测search 自动比对指纹
4基线校验执行前自动比对
5粘连点缺口标记+方案
6历史链搜索n-gram 匹配

工作流程

前置硬约束

  1. 步骤蓝皮书过期检测:search 命令自动比对指纹
  2. 链私有蓝皮书基线校验:执行前自动比对
  3. 门禁系统:10 座 HARD 门禁串行阻断

规划执行流程(串行,门禁阻断)

流程图:串行门禁流 流程图如下,编号列表:

  1. 蓝皮书校验 — 输入: search 指纹; 输出: 已校验
  2. 理解意图 — 输入: 用户原始意图文本; 输出: 时序子意图列表
  3. 步骤搜索 — 输入: 子意图文本; 输出: 候选步骤列表
  4. LLM 选步骤 — 输入: 候选; 输出: 选定 ID
  5. 里程碑 — 输入: 步骤; 输出: 标记
  6. I/O校验 — 输入: I/O; 输出: 分数
  7. 黏连点 — 输入: 缺口; 输出: 方案
  8. DAG+保存 — 输入: 依赖; 输出: 链文件
  9. 健康检查 — 自动基线校验
  10. 执行 — 按计划调用 skill

门禁系统

门禁系统参见渐进式文件索引表

链私有蓝皮书

链私有蓝皮书参见渐进式文件索引表

LLM 参数

LLM 参数参见渐进式文件索引表

自增强闭环

自增强闭环参见渐进式文件索引表

配置

参数类型默认值说明
记忆参考boolfalse创建时读用户记忆
命名方式stringautoAI 命名或询问
默认重试int31-10 可配置
黏连方案stringmanual缺口处理策略:manual/auto/skip

详见 references/blueprint.md。

step_indexer.py search --intent "分析"
step_indexer.py status

相关技能

Agent skill recommender. Input a user need, task description, or existing skill list; output best matching skills, install rationale, duplicate/merge candida...

37 次安装

Discover, install, update, or create the right skill when a workflow gap appears. Use when a task is repetitive, a role lacks a reliable procedure, an existi...

37 次安装1 星标

改任何文件前先看 diff、备份、等用户确认,安全升级已安装的代理技能。

92 次安装6 星标

KinemaClaw cross-platform Skill development and publishing specification. Defines the standard process for Codex and Claude plugin development, version manag...

34 次安装1 星标

全能出行管家技能 — 处理出行规划/行程安排/出差旅游等场景,整合高德地图(路线/天气/周边)与途牛旅行(机票/酒店/火车票/门票**价格查询与比价**)服务,提供场景识别、智能比价、行程规划与行程网页生成。能力与副作用完整披露:(1) 从环境变量读取 AMAP_API_KEY、TUNIU_API_KEY 用于本次查询调用,不跨会话上传第三方;本技能包不含任何密钥文件;(2) **仅调用查询/搜索类接口**(searchLowestPriceFlight / tuniu_hotel_search / searchLowestPriceTrain / query_cheapest_tickets

27 次安装1 星标

1Panel operation skill for agent runtimes. Use when the user wants an assistant to interact with a 1Panel instance for resource monitoring, websites, certifi...

50 次安装2 星标