SuperAPI AI 工具集

dense-multi-agent-worktree-delivery

智能体与模型

查看项目

更新于 10-16 08:04

技能介绍

用途:当需要通过众多协调一致的 agent 推动大规模项目进展时使用本工作流,核心是隔离 worktree、可评分泳道、堆叠 PR、快速验证反馈和外部状态接收端。密集指有证据的受控吞吐,而非失控的 WIP。

模式选择:行动前必须且只能选一种模式——批量模式(新密集产品进展的默认)、单切片模式(用户指定某个 issue/PR/bug/CI 失败或热修时)、收尾/审计模式(已有 PR、CI、脏 worktree 等在途时)。若预检发现收尾债务,则切换到收尾/审计模式。

事实来源优先级:本地 git/worktree 状态与本地重跑验证 > GitHub/Graphite 当前 SHA 的 PR、diff 基、评审与必需检查 > 仓库本地控制器状态 > Linear > Slack > 记忆摘要或子代理报告。Slack 与 Linear Done 永远不是合并事实,子代理报告只是线索而非证据。

主要能力与要求:预检记录仓库真实路径、默认分支、脏文件、worktree 清单、开放 PR、CI 健康、控制器下一步动作等;写操作前先验证所需状态接收端可用;用多智能体规划/评审委员会启动批量模式;将策略转为可评分泳道(含 slug、目标、文件范围、禁区、依赖、堆叠父级、PR 大小上限、评分标准、最快验证命令、首个反馈时限);每个可写泳道使用隔离 worktree;保持 PR 小并堆叠;先窄验证后宽门禁;只提交意图内文件。

执行循环:从实时状态启动/恢复泳道,轮询 agent 并直接检查 worktree,出现合理 diff 即运行最快验证,评审范围/正确性/测试/安全/文档,按 P0/P1/P2 分类,批量修复后重跑受影响检查,验证评审通过后才提交并开 PR,随后更新 Slack/Linear/GitHub/控制器状态。验证分三层:Layer A 最快语义证明(通常 5 分钟内)、Layer B PR 就绪门禁、Layer C 异步/夜间/合并后全回归。默认不在评审前跑长全量门禁。

堆叠治理:根文档/契约 PR 可指向默认分支,实现 PR 指向前一分支;开 PR 前验证每个 diff 相对目标基;分支携带过期父历史或超大 diff 时需 restack;远程 PR 积压时暂停新工作,先按路线、文件重叠、状态聚类;热点文件冲突时顺序合并、fast-forward、rebase 兄弟分支并重跑验证。不得基于过期本地假设合并,需验证当前 head SHA、评审要求和该 SHA 的必需 pull_request 检查。

文档与状态:耐久 markdown 少用,仅当行为/架构/API/存储/运行时/UI 语义或持久运营策略变化时更新;临时进度留在 Slack、Linear、GitHub 评论或控制器。状态更新需区分实现完成、评审完成、本地验证完成、PR 开启/等待 CI、已合并、交付链完成。

收尾契约:报告完成前复查默认分支、head、worktree 清洁度,列出已合并/开放/脏/阻塞/放弃泳道与仍运行进程,确认各状态接收端与现实一致,区分已验证事实与推断,记录确切验证命令与结果。squash 合并后本地分支删除可能需 force delete,仅在 GitHub 合并与本地 fast-forward 验证后执行。

跨运行时与参考:agents/openai.yaml 提供 Codex/OpenAI 风格接口元数据,Hermes 不通过 linked_files 暴露,移植或审计时直接检查。参考文档按需加载(交付操作模型、CI 验证与重复检查、收尾 PM 事实与 worktree 救援、工作流优化附录、产品策略委员会、UX/QA/交付队长委员会、公共标签 CI 反馈循环、Playwright UI 回归陷阱索引、遗留索引等)。

限制:本资料未提供具体收费、价格、平台支持范围等信息;密集模式无固定默认并发上限,由实时证据动态控制,因此需具备可验证的状态接收端与隔离环境。