SuperAPI AI 工具集

orchestration-envelope

智能体与模型

查看项目

更新于 10-15 21:56

技能介绍

用途:这是无头 agentic-workflow 驱动使用的内部机器结果契约,不面向普通交互式技能。交互式技能仍以文本为先,无头驱动只在边界处获得紧凑且经过校验的结果,不会给每个面向用户的技能都附加重复的 JSON 段。

主要能力:可执行的事实来源是 @gtrabanco/agentic-workflow-schema,包含类型、JSON Schema、renderOutputInstruction(skill)、parseTurn(input) 与 compileWorkflowSnapshot(input)。WORKFLOW_SKILL_PROFILES 是权威清单;workflow-status 始终返回严格的 Envelope v2 传感器结果,其 envelope 在 detail 下包含详细项目视图;其他由驱动调用的技能只有在驱动为该次调用追加 renderOutputInstruction(skill) 时才返回 SkillOutcome v1。advance 是指挥者而非工作技能,以确定性代码运行于传感器 envelope 之上,不产生 SkillOutcome。

使用方式:驱动读取配置文件,仅为受驱调用追加 renderOutputInstruction(skill);将最终响应传给 parseTurn({skill, text, context}),并把返回的 source 与 diagnostics 保存在运行日志中。若机器结果缺失、格式错误或无效,可对同一会话重试一次,仅输出本轮机器结果;再次失败即为驱动级 FAILED,不得无限重试或把任意文本当作工作流事实。

限制:兼容性刻意收窄,仅能修复已知值的遗留 v2 形状;无问题标识的非零问题数、未匹配的数字单元 ID 或无关文本均视为无效并上报驱动。Envelope v2 对新驱动严格,detail 必填且技能特定扩展置于其中。SkillOutcome v1 与 WorkflowSnapshot v1 为独立的版本化 JSON Schema,破坏性变更属主版本变更。驱动在规划前调用 discover-repository-state,并保留冻结的 docs/workflow/REPOSITORY_STATE.md 引用;WorkflowSnapshot v1 保留未知项、来源与已声明的矛盾,由 resolve-repository-state 处理矛盾。