用途:把基于 Markdown 的技能文档(SKILL.md)转换为结构化的调度-结构-逻辑(SSL)表示,便于智能体检索、推理与审计。SSL 分三层:调度层(何时/由谁调用,含 id、name、goal、intent_signature、inputs、outputs、dependencies、control_flow_features、entry_scene、subscene_refs);结构层(宏观执行阶段即 scene,含 type、goal、entry_condition、exit_condition、next_scene_rules、inputs、outputs、entry_logic_step);逻辑层(原子操作即 logic step,含 action_type、resource_scope、description、inputs、outputs、next)。
主要能力:四轮流水线——Pass 1 调度提取、Pass 2 场景分解(建议 2–5 个场景)、Pass 3 逻辑步骤展开、Pass 4 校验(JSON 语法、必填字段、枚举成员、ID 唯一、入口指针、场景与步骤包含关系、转移有效性、图完整性)。使用受限枚举:场景类型 PREPARE/ACQUIRE/REASON/ACT/VERIFY/RECOVER/FINALIZE;动作类型 READ/SELECT/COMPARE/VALIDATE/INFER/WRITE/UPDATE_STATE/CALL_TOOL/REQUEST/TRANSFER/NOTIFY/TERMINATE;资源范围 MEMORY/LOCAL_FS/CODEBASE/PROCESS/USER_DATA/CREDENTIALS/NETWORK/OTHER;终止目标 END_SUCCESS/END_FAIL 与 YIELD_SUCCESS/YIELD_FAIL。
使用方式:以 skill_path 指向目标 SKILL.md 调用,依次运行四轮;Pass 4 失败时由 RECOVER 在有限重试预算(建议 ≤3 次)内重试。主输出为与源文件同目录的 ssl.json(顶层键 scheduling、scenes、logic_steps),次输出为校验与规范化报告(含处理数、有效/拒绝数、解析/模式/图/枚举失败、重试次数及逐件诊断)。批量处理时每个文档调用一次并汇总报告。
限制:仅提取源文档直接支持的信息,不虚构行为、工具、依赖或副作用;类型字段只用受限枚举;证据不足时用 null、空数组或粗粒度分类;拒绝而非静默修复非法输出;报告不得暴露密钥或凭据;尽量保持确定性。成功需输出通过全部 Pass 4 规则且引用可解析;失败情形包括缺少必需图结构、转移无效、需无依据推断、重试后仍存在校验错误。