SuperAPI AI 工具集

crew-delivery

智能体与模型

查看项目

更新于 10-15 17:32

技能介绍

用途:在同一个代码仓库上协调多个 Pi 智能体,像人类团队一样分工。仅在用户已配置多个智能体(pi-messenger Crew 或多个 Pi 会话)时使用;它本身不创建委派,单智能体时仍按串行方式内联工作。该技能仅提供技能,不含工单自动驾驶运行器、调度器或驱动器。

角色与技能:PM 负责规格、工单、分配与合并队列,使用 to-spec、to-tickets,不写产品代码,在自己的 worktree 工作,仅通过队列进入 main。开发者一次处理一个工单,编写代码与测试,使用 execute-ticket,在自己的 worktree 与分支工作。评审者审核每个分支并做周期 QA,使用 code-review、qa-test-plan,只读。任何人都不在 main 文件夹中写入;安装 pre-commit 钩子拒绝在 main 分支提交,合并队列只做快进合并。

工单循环:PM 在 crew/plan 分支用 to-spec 和 to-tickets 生成规格与工单,经队列进入 main。工单是请求的完整切片,由自身测试闭环;两个在途工单不得触碰同一文件,涉及全局的改动算一个工单。每个开发者每个请求最多分配两个工单,一次一个。角色可做的事写在工单的 ## Gates 中,工作中不得等待确认。

开发者:git worktree add -b crew/<ticket-id> ../<repo-folder>-worktrees/<ticket-id> main,然后只在该处工作。用 execute-ticket 内联携带工单但跳过其评审阶段。运行仓库测试,在分支提交并交付分支名与已运行的测试。若无法安全完成,停止并交付分支状态与具体原因,不要拆小重试。

评审者:在该 worktree 中对 git diff main...crew/<ticket-id> 运行 code-review,上下文与开发者分离。结论为 approved 或 changes requested 并附发现。修改退回同一开发者,评审者不编辑;每次 changes-requested 计为一次阻塞。

合并队列(PM,一次一个分支,不手工编辑):在开发者 worktree 中 git rebase main(冲突则 git rebase --abort,工单退回开发者),运行仓库测试,然后 git -C <main-folder> merge --ff-only crew/<ticket-id>,git worktree remove 并删除分支。

阻塞工单:PM 不完成它,而是改写为更清晰的工单、合并到另一工单或重新分配。同一工单第二次阻塞则停止请求并记录原因。

周期 QA:当请求的所有工单合并后,评审者在 main 上运行 qa-test-plan 与完整测试。每个问题由 PM 生成新工单并走同一循环。只有 main 上 QA 通过才算完成;开发者的“完成”、worktree 中绿色测试或工单文件都不是结果。

限制:共享资源(数据库、主机、长运行服务)同一时间只有一个所有者,默认为 PM,除非工单的 ## Gates 另行分配。智能体之间的报告须陈述事实与证据(命令与结果),而非就绪状态。