SuperAPI AI 工具集

moai-kanban-foreman

智能体与模型

查看项目

更新于 10-16 09:59

技能介绍

用途:在项目中以无人值守方式运行一次(及后续多次)看板工头循环,负责监视 backlog 队列、把操作者已挑选的下一张卡片派发给隔离的 worker、收集完成证据并生成汇报。队列界面为 moai todo,派发协议与卡片类别定义在 kanban 派发规则(.claude/rules/moai/workflow/kanban-dispatch.md)。

主要能力与使用方式:启用该技能时 AskUserQuestion 会从工具池移除,从而机械性保证循环不会停下来提问;本应提的问题变成迭代报告中的一行,真正需要操作者决策的事项成为被阻塞的卡片。部署方式:在项目中启动会话,运行裸 /loop,然后将会话置于后台;循环任务会转移到后台会话持续运行。Esc 可取消等待中循环的待唤醒;循环创建七天后过期,需要时重新启动。后台监视器在会话恢复后不存活,恢复后第一次迭代会重新武装队列监视。

硬性边界:操作者负责准入与挑选工作,只有状态已为 picked 的 backlog 项可派发;绝不运行 moai todo add,绝不运行 moai todo next <n>;不得编造、改写或重排卡片。空队列是合法状态。不为操作者代答任何审批门。同一时间最多一个可写 worker,worker 在飞行中迭代只读。每个 worker 在自己的 worktree 中运行(spawn 时 isolation: "worktree"),不向共享检出写入。不执行集成动作:不 push、不建 PR、不 merge、不删分支、不清理 worktree。验证为 lane-local,完整测试套件属于 CI。完成状态只读取证据,绝不信任口头声明。

迭代流程:武装队列监视(对 backlog 文件每 5 秒校验和轮询,持久化,不缩短间隔、不添加第二个监视器);用 moai todo list --json 读取队列(缺文件即空队列);先收集再派发;选择最旧的、无活跃 worker 且无记录阻塞的 picked 卡片;用 Agent 工具派发一个 worker,派发为固定字段地址块;worker 需先重命名 worktree 分支为 WT-<slug>,实现卡片、lane-local 验证、写证据文件、按显式路径提交、绝不 push;仅在证据显示完成时才执行 moai todo done <t-id> 推进卡片;最后以两到六行汇报。

限制与预留:多 lane 工厂派发尚未实现,当前只支持单 worker 派发模式。权限需事先在项目设置中预批,否则无人值守时权限提示会卡住迭代。队列文件反复不可读、无法武装监视或技能本身损坏时,应停止循环。