SuperAPI AI 工具集

planning

智能体与模型

查看项目

更新于 10-16 01:33

技能介绍

用途:该技能用于设计依赖感知的任务图,并在编排器中通过 create-tasks 提交,供后续执行者按依赖顺序完成。它只面向需要协调的工作,例如多个工作流、工作流之间的依赖、跨任务共享数据表结构或迁移、多个持久产物、跨多来源的广泛最佳实践调研,以及单个 build-workflow 调用无法解决、确实含混的业务流程架构;或用户明确要求先审阅计划。

不适用场景:新建或一次性的单个工作流(即使看起来庞大或陌生)、对已有工作流的修改(节点、表达式、凭证、计划、Code)、刚构建工作流的验证/设置/凭证收集、随同一工作流发布的工作流本地数据表,以及独立的数据表查询/创建/变更工作。单工作流应使用 workflow-builder 加 build-workflow;独立数据表使用 data-table-manager。若涉及共享数据表,应先加载 data-table-manager,并把相关表指引带入工作流任务规格。

方法:以“是否需要协调”而非“工作流是否新建”判断是否值得规划。先用常规工具发现影响计划的信息,如 nodes(action="suggested")、credentials(action="list")、data-tables(action="list")、parse-file、workflows 及调研。优先做合理假设而非提问。构建依赖图,生产者先于消费者。单工作流本地表需求写入该工作流任务规格。仅在常规验证无法覆盖的语义检查中添加 checkpoint 任务。必要时通过 load_tool 加载 create-tasks,再以 planningContext.source: "planning-skill" 调用,附简要摘要、可选假设,仅在用户明确要求构建后运行/执行/测试时设置 postBuildRunRequested: true。调用后不写可见文本,审批卡片即用户可见界面。

任务图规则:任务类型仅限 build-workflow 与 checkpoint;任务 id 需稳定且被依赖边引用;标题简短面向用户;规格必须是完整的执行者简报。build-workflow 规格按顺序包含 Outcome、Trigger mode、External systems、Required effects、Required branches、Required data、Explicit constraints、Empty/invalid behavior、Done when,其中 Required effects 列出所有可观察动作,Explicit constraints 保留用户提供的资源名、频道、表、标签、URL 及指定节点族。支持型子工作流设 isSupportingWorkflow: true。

假设与提问:不询问工具可发现的事项,也不询问有合理默认的实现细节;一次只问一次,已回答、延后或跳过的不再重复。资源标识符若用户未提及不擅自默认。

检查点与修订:工作流验证由结构化构建结果自动完成,仅对跨工作流契约、业务不变量等特殊语义检查设 checkpoint。用户要求修改计划时做外科式修订并再次调用 create-tasks;用户彻底拒绝则停止,不在同一消息组内再次调用。