SuperAPI AI 工具集

orchestrate-work

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:把一项有边界的实现委派给一个隔离的 Codex 执行器。执行器是唯一写入者;父级保持只读,掌握授权、决策引导、评审处置和验收。成功条件是:执行器从已验证仓库与确切基线开始,变更前双向回调可用,影响决策的工作先到父级,用户最终得到已接受结果或确切可恢复状态。

主要能力与约束:授权由已接受的请求、计划或规范定义,超出范围需暂停并回用户获取新授权。每个目的地自持模型与思考设置,默认全部省略,只对指定目的地应用显式且符合 schema 的覆盖,不得复制发送方设置。发布方式是显式的:none、commit、push、pull request 或 merge,其中 pull request 含必需 push,merge 需用户授权。就绪命令显式指定:用目标仓库的命令或 none,不得推断包管理器配置。保持单一写入者:执行器拥有其 worktree、编辑、提交、验证和所需评审机制,父级只读检查。

使用方式:填写执行器契约,用 handoff-work 提供简明上下文并指向持久来源而非复制。用 codex_app__list_projects 选择匹配仓库的项目,身份缺失或有歧义时停止。检查实时的 codex_app__create_thread schema,然后以最小项目目标创建一个隔离 worktree:{ prompt: "[完成的委派与交接]", target: { type: "project", projectId: "[发现的 project ID]", environment: { type: "worktree" } } }。只加显式且符合 schema 的目的地覆盖,仅在已接受任务选择了起始状态时使用。只创建一次;校验被拒表示未创建任务,应按实时 schema 更正后重提。结果有歧义时用 codex_app__list_threads 和 codex_app__read_thread 匹配项目、提示与创建时间窗,只有发现确认不存在时才重试。记录执行器任务 ID,用 list 或 read 解析排队的 clientThreadId 后再引导,用 codex_app__set_thread_title 设置标题,验证项目与全新 worktree。

要求变更前检查点:实际 worktree、分支或 detached-HEAD 状态、准确的 git rev-parse HEAD、干净状态、确切就绪命令、拟改文件面、既有接缝与实质冲突;基线不匹配即暂停。变更前验证双向回调:执行器到父级用外层 <source_thread_id> 的父 ID;父级到执行器用 codex_app__list_threads 或 codex_app__read_thread 返回的 { threadId, hostId } 路由。回调来源标识执行器而非父级。已核实的本地任务在实时 schema 允许时可省略 hostId,否则用发现的路由 hostId。source_host_id 和标题更新输出不是引导路由。要求执行器在首个检查点前检查 codex_app__send_message_to_thread,父级首次回复前同样检查,用成功发送加读回或确认证明送达。父级确认即把报告的就绪命令授权为有界设置,执行器在改源码或调用服务商前运行;失败则带确切证据暂停,成功无需二次批准。仅当仓库身份、确切基线、隔离、双向回调和就绪都验证后引导才算完成,否则报告 blocked。

决策检查点:执行器在编辑前、实现连贯时、被要求评审时和最终交接时报告;出现决策或阻塞可随时咨询父级。每个检查点含证据、边界影响、一条建议和继续或暂停。范围或授权变更、产品或架构选择、破坏性或未授权外部操作、评审处置、不安全重叠、意外路由或运行阻塞时暂停;只有需要新授权的决策才回用户。每个检查点独立核查实质声明并发出一条有界指令:proceed、correct、pause 或 stop,并说明下次所需证明。常规范围内的实现留给执行器。在决策、异常和里程碑时更新,不轮询未变状态。评审被要求时,执行器遵循 change-review-workflow,报告每个角色与底层问题,提出问题局部处置,并在修复前暂停;父级批准或调整处置。将当前 head 评审记录为 approved、unresolved 或 not requested。检查点完成条件:实质证据已核实、一条指令已送达并确认、下次证明明确。

关闭或停止:正常完成时要求 handoff-work 交接,含确切分支与 tip、干净状态、diff、验证、当前 head 评审、发布、注意事项与待决事项;核实证据与当前已接受的发布授权,然后确保执行器停止。取消或取代时,若支持则中断;否则指示执行器完成当前安全原子操作、停止变更与发布、报告确切的 Git/worktree 可恢复状态,并在替换工作前核实其已停止。返回状态、分支/tip 或 pull request、验证、评审结果、注意事项与待决事项。完成要求得到已接受结果或向用户报告的确切未解决状态,且执行器已停止。

限制:以上流程、命令与 schema 用法均来自所给资料;官方收费、价格与平台支持等未提供。