SuperAPI AI 工具集

sequential-orchestration

编程与开发

查看项目

更新于 10-16 08:04

技能介绍

用途:该技能用于按顺序逐个执行 Kiro spec 中的任务,并提供 tmux 可见性,适合需要串行、可控速率的编排场景(如触发限流、夜间运行)。

主要能力:解析 tasks.md 并加载或初始化 SEQUENTIAL_STATE.json;为每个调度单元分配任务;逐次查找下一个未完成任务、派发到 tmux 窗口(task-{id})、同步等待完成、更新状态并检查 COMPLETE/HALT 信号;完成后输出汇总,报告成功与失败数量及关键变更。脚本还会自动生成 .kiro/specs/SEQUENTIAL_STATE.json 与 .kiro/specs/SEQUENTIAL_PROGRESS.md 供人工查看。

用法:在 scripts/ 目录下运行 python scripts/sequential_loop.py --spec .kiro/specs/my-feature,可附加参数:--delay 15 控制任务间间隔秒数,--max-iterations 50 限制最大迭代,--backend opencode 指定执行后端,--assign-backend codex 指定分配后端,--tmux-session 命名 tmux 会话。通过 shell 工具调用时建议设置较长超时(如 7200000 毫秒)。退出码:0 表示完成,1 表示达到最大迭代,2 表示收到 HALT 需人工介入。

监控:可用 tmux ls、tmux attach -t 会话名、tmux select-window -t task-1.1 查看进度,或读取 SEQUENTIAL_STATE.json。若任务输出 HALT 标记则编排停止并等待人工处理。

限制与安全:运行脚本可能调用 agent 后端并修改文件;可通过设置 CODEAGENT_NO_TMUX=1 禁用 tmux。该技能读取仓库中的 spec 文件并写入状态文件,资料称不涉及密钥操作。代码改动建议遵循 test-driven-development 技能(RED->GREEN->REFACTOR)。其余细节以仓库实际脚本为准。