AI编码多智能体协作工作流

AI编码多智能体协作工作流

5个可下载技能 · 5步自动化工作流 · 每个技能可单独运行

多个编码智能体同时工作时，真正困难的不是让它们各写一段代码，而是让任务基线、路径所有权、依赖、冲突、测试证据和合并顺序保持一致。本套餐把一个编码任务整理成可审计合同，按能力与依赖规划隔离工作区，审计路径和公共符号冲突，校验每个结果是否满足同一合同，最后生成需要代码所有者批准的人工合并队列。5个技能都是本地确定性Python脚本，只处理脱敏元数据；不读取源码、不克隆仓库、不执行生成代码、不创建工作树、分支、提交、PR或合并，也不替代代码审查、测试平台和发布审批。

5步自动化工作流

1 规范编码任务合同

对应技能： coding-task-contract-normalizer

解决什么： 固定任务目标、仓库快照哈希、允许与禁改路径、依赖、风险等级和验收检查，阻止不同会话自行猜测范围。

What you get: 稳定任务合同、contract_hash、READY/BLOCKED、blockers和仅处理元数据的执行边界。

流转到下一步： 任务ID、路径边界、能力要求和依赖进入分派规划，成为所有智能体共享的唯一基线。

2 规划智能体工作区分派

对应技能： coding-agent-worktree-allocation-planner

解决什么： 按能力匹配工作项，生成依赖波次、唯一分支名和隔离工作区槽位，并提前暴露声明写路径重叠。

What you get: assignments、dependency_waves、declared_overlaps、warnings和不实际创建仓库对象的计划。

流转到下一步： 每个工作项的声明路径、依赖和分支归属进入冲突审计，与智能体返回的变更声明逐项对照。

3 审计并行代码变更冲突

对应技能： parallel-change-conflict-auditor

解决什么： 在读取源码或合并前审计相同路径、公共符号、迁移ID和越界路径，避免多个智能体对同一接口产生互不兼容的修改。

What you get: 冲突类型、涉及工作项、严重度、conflict_count和BLOCK_FOR_RECONCILIATION或可继续校验的门禁。

流转到下一步： 冲突证据与每个工作项的基线、提交声明和检查结果一起进入结果合同校验。

4 校验多智能体结果合同

对应技能： multi-agent-result-contract-validator

解决什么： 确认所有结果来自同一仓库快照、提交ID格式有效、必需检查已通过、变更路径没有越界，且工作项确实完成。

What you get: validated_results、merge_candidate_count、逐项issues、blockers和READY/BLOCKED状态。

流转到下一步： 只有合同校验READY的候选才进入最终队列；冲突不会被校验结果掩盖，而是作为先决人工任务保留。

5 生成人工合并队列

对应技能： coding-agent-human-merge-queue-builder

解决什么： 先安排冲突协调，再按依赖顺序生成候选分支复核、所需审核人和每步回滚检查点，防止智能体直接把并行结果合进受保护分支。

What you get: P1/P2队列、required_reviewers、冲突协调项、依赖化合并顺序、rollback_checkpoint和HUMAN_APPROVAL_REQUIRED。

最终交付： 一份可交给代码所有者执行的人工合并计划；本技能不提交、不推送、不建PR、不合并也不发布。

实际示例

随包样例使用一个虚构的订单状态组件任务，只含任务ID、相对路径和哈希。第一步生成统一合同与64位哈希；第二步把合同、前端和测试三个工作项分给三类能力，并形成3个依赖波次，同时发现src/contracts/order.ts被两个工作项声明；第三步进一步识别该路径重叠和OrderStatus公共符号冲突，输出HIGH与BLOCK_FOR_RECONCILIATION；第四步确认3个结果来自相同基线、都通过两项检查且没有越界路径；第五步生成P1人工队列，先协调冲突，再按合同、界面、测试顺序复核3个候选，共4个队列项和2类审核人。以上只是确定性程序测试，不是真实仓库、客户项目、代码质量结论或已完成合并。

适合谁

• 同时使用Codex、Claude Code、GitHub Copilot或其他编码智能体处理多个工作项的研发团队

• 需要把多会话结果交给代码所有者统一检查，而不是让智能体直接合并的技术负责人

• 为Agent Skills、MCP工具、插件、网站或内部系统建立并行编码审计台账的交付团队

• 需要在不上传源码正文的前提下记录基线、路径所有权、测试证据和回滚顺序的安全与合规团队

买家只需提供

• 脱敏任务ID、目标、仓库快照SHA256、允许路径前缀、禁改路径、依赖、风险等级和验收检查ID

• 智能体ID与能力标签、工作项ID、依赖和声明写路径；不要提供个人账号或私有仓库URL

• 每个结果的基线哈希、提交ID、变更路径、检查状态，以及不含diff和源码正文的冲突声明

使用方式

1. 使用Python 3.10或更高版本，按各技能README准备UTF-8 JSON；无第三方依赖。

2. 依次运行任务合同、分派规划、冲突审计、结果校验和人工合并队列，也可把任一步接入现有研发工单或CI证据流。

3. 先用随包样例验收路径重叠、符号冲突、相同基线、两项检查和依赖顺序，再由有权人员在官方Git与CI工具中审查、解决冲突和执行合并。

交付与验收

• 交付5个独立技能目录，每个包含_meta.json、SKILL.md、agents/openai.yaml、README、Python执行器和脱敏输入输出样例。

• 5个脚本均可离线重复运行，相同输入产生稳定JSON；技能数与工作流步数精确为5。

• 验收合同哈希、路径边界、能力分派、依赖波次、路径与符号冲突、相同基线、检查证据、审核人和回滚检查点是否按样例触发。

• 输入缺失、依赖成环、无能力匹配、基线不一致、检查缺失或越界路径都会输出blockers；不读取源码、不执行代码或测试、不创建工作树、分支、提交、PR、合并或发布。

服务说明

本套餐只处理组织有权使用且已脱敏的研发元数据，不接收源码正文、diff、私有仓库URL、真实客户数据、账号、密码、令牌、Cookie、密钥或未授权个人信息。路径重叠、符号冲突和检查通过都只是复核证据，不能单独证明代码错误、安全、性能达标或可以发布；脚本也不验证测试报告真实性。买家必须在受保护分支、最小权限、代码所有者审查、CI、制品签名、变更管理和回滚制度下执行后续动作。本资源不承诺零冲突、零缺陷、固定节省时间、代码合规或业务结果，也不包含仓库托管、CI额度、模型订阅、人工开发、代码审查或发布值守。