skill-sub

# 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 可以替代 | | 缺少 solutions | adhesion 步骤没有提供方案 | 至少加一个 manual 方案 | | 依赖不存在的步骤 | depends_on 引用了无效索引 | 检查依赖步骤的 index 是否正确 | | 引用的 skill 不存在 | skill_name 对应的 skill 未安装 | 检查 skill 名称是否正确 | | 检测到定时/自动化意图，但未提供 --schedule | 描述中含"每天/每周/定时"等词但没给调度配置 | 添加 --schedule 参数，或删除描述中的时间相关词 | > **强制规则**：用户描述中包含定时/自动化意图（如"每天"、"每周"、"自动执行"等）时，**必须**提供 `--schedule` 参数配置调度信息，否则链创建被拦截。 不依赖 AI 自觉判断。 ## 触发条件 **正向触发：** - 规划类：「帮我规划一下...」、「...的步骤是什么」 - 顺序类：「依次执行 A、B、C」、「先...再...」 - 链管理：「创建/查看/更新/删除调用链」 - 步骤搜索类：「搜索步骤」、「找步骤」 - 链健康检查：「检查链的健康状态」 - 仅涉及单个 skill 的简单任务 **否定条件：** - 明确要求「不使用调用链」 ## 触发场景 **正向触发**： - chain_executor.py - Chain Executor v1....