SuperAPI AI 工具集

kstack-orchestrator

通用与其它

查看项目

更新于 10-15 23:47

技能介绍

用途:在单个 agent 无法连贯完成、且至少两个结果可独立推进时,把工作分派给受限 worker。它强调先证明委派有价值,再提出有界扇出,执行权限仍归 Pi、Herdr 和 Git。

主要能力:按结果分类 worker——只读、写入、依赖、冲突;依赖与冲突结果需串行,只读 worker 可共享 checkout,并发写入必须使用独立 Git worktree 与分支。通常最多提议两个实现 worker,更大扇出需明确批准。

使用方式:先向用户展示每个 worker 的单一目标、分类、checkout/worktree/分支计划、真实依赖与冲突、预期证据及委派理由;获批后加载已安装的 herdr 技能,按其指引检查环境、发现 CLI、解析返回 ID。为每个 worker 选择唯一的 Herdr 安全名称与小写 Pi 会话 ID,写入者在指定 worktree 中启动 kstack --session-id <id> --name <worker-name>,并创建唯一完成标记。观察阶段使用 Herdr 的机械等待与读取操作,等待任务专属完成标记,而非轮询模型。

验证与限制:读取结果包与仓库证据而非 worker 转录;对要合并的变更,需指定精确提交或 diff,启动新的验证者会话,排除实现对话与自我认证。修订变化或观察不可用视为过期或阻塞。worker 意外退出时保留 worktree 与会话并询问后再恢复,不自动重启。未经明确批准不得合并、发布、删除 worktree 或移除分支。若 herdr 技能、HERDR_ENV、CLI 或所需能力不可用,报告缺失依赖并停止编排,普通单 agent Kstack 仍可用。