SuperAPI AI 工具集

step-running

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:step-running 用于把 DAG 计划中的单个步骤当作原子后台子智能体来执行,自主运行至完成并汇报结果,不与用户交互。它是 phase-running 的 DAG 对应版本,执行模型与原子性契约相同,区别在于接收的是 step-<n>.md 文件路径而非计划路径加阶段号,并通过步骤 frontmatter 的 status 字段原子化声明步骤,使同一计划目录可被多个编排器实例安全驱动。

主要能力:接收步骤路径、计划目录、Agent ID 与调用方上下文;执行前读取步骤文件与 root.md 获取计划级上下文;进行预检(依赖步骤是否 done、目标文件是否有合并冲突、依赖产物是否存在);实现步骤中“Changes Required”描述的变更;运行自动化验证与自动化 QA,失败时尝试一次修复重试;更新步骤文件复选框与 frontmatter 状态;最后汇报状态、变更文件与验证结果。

使用方式:由 v-implementing 或用户调用 /run-step 通过 Agent 工具以 run_in_background: true 启动。声明步骤时读取 frontmatter:若 status: done 则报告 skipped 退出;若已被他人声明且未过期则报告 blocked;过期声明(超过 1 小时)可覆盖。声明时以单次 Edit 重写 frontmatter,设置 status: claimed、assignee、claimed_at,并重读确认未输掉竞争。完成时置 status: done 并清空 assignee 与 claimed_at;可重试的阻塞或失败置回 ready;不可重试的失败保留 claimed 供编排器排查。

适用场景:适用于由 v-planning 生成、需要多编排器并发驱动的 DAG 计划步骤执行,尤其是需要原子声明、自动验证与结构化汇报的后台任务。

限制:步骤智能体不使用 AskUserQuestion,遇到歧义只能报告 blocked;手动验证项不勾选,由调用方处理;QA 规范文档只报告路径,不内联执行;单次 Edit 的原子性仅适用于本地文件系统与行为良好的网络文件系统,跨机器真正原子性需调用方提供会合机制(如共享锁服务)。