SuperAPI AI 工具集

run-orchestrator

编程与开发

查看项目

更新于 10-31 13:14

技能介绍

run-orchestrator 是 archon 项目提供的技能,专门用于复杂功能和多文件改动的测试驱动开发(TDD)编排。其触发场景包括:用户调用 /run 命令、要求构建/创建/实现某个功能、或提出需要复杂多文件改动的请求。明确不适用于缺陷修复(应改用 bugfix-quick 技能)和快速编辑(直接修改即可)。

工作流程

技能采用五阶段 TDD 工作流:

  1. 理解与设计:由 architect 构建,tester、security、strategist 评审,需人工审批。输出限制在 500 token 以内,以 TOON 表格呈现范围、验收标准、技术要点和风险。
  2. 测试先行(Test RED):由 tester 编写失败测试,architect 做可行性评审,自动流转。测试层选择需在写测试前明确(单元/集成/端到端)。
  3. 实现通过(Build GREEN):由 architect/frontend/mobile 实现,tester、security 评审,需人工审批。
  4. 重构与评审:由第三阶段构建者重构,security 与 tester 评审(评审者不能是同一构建者),自动流转。
  5. 收尾:由 lead 负责,自动流转。

状态与交付物

技能要求在执行任何工作前先创建 .claude/logs/runs/${RUN_ID}/run-state.json 状态文件,用于 /run status、/run resume、/run handoff 读取,并保持当前阶段、活跃智能体等字段同步。随后通过脚手架脚本为每个阶段生成 Markdown 交付物,如需求文档、技术规格、测试计划、实现说明、代码评审、QA 报告、变更日志等;进入审批门禁前会校验文件存在且非模板内容。

升级与联动

技能包含升级检查:对任务描述按多特性、跨会话、范围动词等八项信号加权,达到阈值且无计划树时提示用户选择先建计划或继续。还可与计划树锚定、Jira 工单上下文获取(通过钩子读取工单 JSON)、功能链接脚本(link-run.sh)联动,在收尾阶段更新链接状态。

适用与限制

适用于标准、深度、项目级复杂功能开发,每个任务完整走五阶段,功能需逐任务重复 /aura-frog:plan 后再进入 /run。快速/直接编辑运行可跳过阶段交付物脚手架。运行依赖 Claude 环境的插件脚本与钩子;Jira 集成需配置相应环境变量。