SuperAPI AI 工具集

orchestrate

智能体与模型

查看项目

更新于 11-04 04:19

技能介绍

用途

Orchestrate 是一个编排型技能,用于把所有者(owner)提出的功能或问题转化为一份经其批准的计划,在各仓库的工单(ticket)之间分派工作,把计划状态保持在 workbench 中,并运行计划直至公告关闭。提示词或简报中提及该技能即为其调用方式。

主要能力

  • 计划管理:提出目标、完成标准(Done means)、工单表和关闭评审,交由所有者批准;记录提案与批准;在批准前可进行研究、归档和简报准备。在计划批准记录之前,暂停工单就绪状态阻塞执行。
  • 工作台(Workbench):一个纯 Markdown 的 git 仓库,保存所拥有的每个计划的状态,位于项目仓库之外,为所有者私有记录。包含 index.md(跟踪仓库、计划与所有者、启动上限)、inbox.md(决策收件箱)、wishes.md(愿望清单)、now.md(当前状态)、incoming/(来自任意会话的消息)、每个计划的 plan.md(当前状态)、log.md(只追加历史)、retro.md 及其他记录。
  • 受理(Intake):按贡献指南的 Triage 部分和 triage 技能的方法,在分诊运行中路由每个新请求;自己的建议放入所提 issue 的 Suggestions 标题下。
  • 质询(Grill):当指南的推断测试无法解决意图问题时,与所有者开启质询,然后按指南决定拆分、归档 issue 并接受简报。
  • 运行(Run):启动计划的工单工作者并观察进度;按指南的 Findings 部分处理发现项(Finding);对计划中途到达的新需求,按三种路径处理:若服务于目标且通过推断测试,作为 Row 加入并记录;若改变目标或范围,提出修订(Amendment),经所有者批准后生效;若在目标之外且非 Finding,加入 wishes.md。
  • 关闭(Close):当所有行(row)结束后,协调计划的 issue,运行关闭评审,并作为最后一次计划更新公告关闭。
  • 等待步骤:仅当 now.md 中 In flight 的每一行都在等待所有者,或已通过 harness 自身事件机制设置唤醒时,才结束一轮;Next check 命名该唤醒,并在 harness 支持时用 wait 脚本设置。每次等待也监视 incoming/,当无其他需要时单独监视。若 harness 无法后台等待或投递事件,报告该限制并在每轮重新读取记录。
  • 回写(Report-back):计划目录中的文件是契约。质询、分诊运行或关闭评审通过把结果写入该文件、在 plan.md 中设置完成标记并提交推送两者来报告;其他会话写入 incoming/。若 harness 提供直接消息,仅作为提示,丢失不影响,以文件为准。

使用方式

以提及该技能的提示词或简报调用。技能会读取 workbench,依据各仓库的 CONTRIBUTING.md(Triage、Readiness、Comments、Findings、Pull requests 部分)和 AGENTS.md(Agent skills 要求)执行流程。会话一次只拥有一个计划,在计划关闭时以及接管后发生任何压缩后移交。工作台无远程时以本地 git 仓库运行;有远程时推送。缺失文件时按技能规定创建或按默认规则处理。

适用场景

适用于需要把功能或问题跨多个工单、跨多个仓库规划并跟踪执行的项目,尤其是使用 CONTRIBUTING.md 定义贡献流程、使用 workbench 保存计划状态的团队。

限制

  • 依赖 harness 的事件机制来设置唤醒;若无法后台等待或投递事件,只能每轮重新读取记录。
  • 依赖 babysit 技能的 GitHub CLI 连接来启动 wait 脚本;缺失时无法启动等待脚本。
  • 计划批准不替代独立的简报评审或指南与已安装规则中的其他就绪条件。
  • 所有者要求立即处理时仅跳过计划(加急变更),不跳过其他就绪条件。
  • CONTRIBUTING.md 缺失时按技能方法执行,并把它留给指南的每条规则作为决策放入 inbox.md。AGENTS.md 缺失时每次启动仅给任务上下文,并在支持命名时按操作和目标命名会话。
  • 缺失工作台时需按 templates 创建;缺失跟踪仓库的 Repository Standards 采纳记录时使用示例源。

暂未提供

  • 官方定价、收费方式与平台支持信息。
  • 具体安装命令与依赖版本要求。
  • 该技能的公开效果评测或性能数据。