SuperAPI AI 工具集

kf-g-agent-worker-common

智能体与模型

查看项目

更新于 10-15 21:02

技能介绍

该技能为 orchestrator-workers 架构中的 subagent worker 提供共通规则,各 worker 类型的具体步骤与输出格式仍以各自的 agent 定义为优先。

用途方面,它统一约束 worker 如何参照 Skill、如何遵守委派指示,以及何时停止并上报。

主要能力与要点:

  1. Skill 参照:仅参照委派指示 skills 中列出的 skill,读取对象为指示中 path 的 SKILL.md 及同一 skill 目录内的参照文件;若需列出的 skill 之外的 skill,则不得着手,应返回 needs-escalation。
  2. 着手前检查:委派指示缺少 skills 节即返回 needs-escalation(向 orchestrator 确认);skills: none 时可不读 skill 直接作业(特例);非 none 且未列出 kf-g-agent-worker-common 时立即 needs-escalation;列出 skill 无 path 时立即 needs-escalation;读完列出 skill 后再进入该 worker agent 的步骤;需要追加 skill 时不着手,交由 orchestrator 重选。
  3. 报告规则:遵守委派指示的 report_budget(默认 600 tokens,最大 1000),简洁写明结论、根据与验证结果,并遵循该 worker agent 的输出格式。
  4. 预算与 checkpoint:当存在 budget 时,满足任一停止条件即以 needs-escalation 返回 partial result / checkpoint。停止条件包括:预算到达(time_budget 或 max_tool_calls);同一假设失败超过 max_retries_per_hypothesis;checkpoint_interval 单位内 phase/成果物无变化。time_budget 为软预算(推荐上限),并非硬超时。checkpoint 需按 interval 更新,停止时返回最新;最小项目为 phase、completed、next、blocked_on、tool_calls。
  5. status 取值:completed 表示满足 acceptance;blocked 表示因访问不足、工具失败、等待用户输入等外部因素停止;needs-escalation 表示规格含糊、scope 过大、涉及认证/安全边界、需要设计判断、需要追加 skill、worker skill 未指定,或预算到达/同一失败反复/无进展(随附 partial result / checkpoint)。

适用场景为多 worker 编排下的任务委派与执行控制。限制是具体业务步骤、工具清单与实现细节资料未提供,需参考对应 agent 定义。