用途
本技能用于协调多个实现者智能体并行开发同一功能。它帮助把功能分解为并行的工作流,建立文件归属边界,避免冲突,并整合多个实现者的产出。适用于以下时机:为并行实现而分解功能、在智能体之间建立文件归属边界、设计并行工作流之间的接口契约、选择集成策略(垂直切片还是水平分层)、管理并行开发的分支与合并工作流。
主要能力
文件归属策略
按目录:为每个实现者分配特定目录的所有权,例如 implementer-1 负责 src/components/auth/,implementer-2 负责 src/api/auth/,implementer-3 负责 tests/auth/。适合目录边界清晰的代码库。
按模块:分配逻辑模块的所有权,模块可能跨越多个目录,例如 authentication 模块(login、register、logout)与 authorization 模块(roles、permissions、guards)。适合面向功能的架构与领域驱动设计。
按层:分配架构层的所有权,例如 UI 层(components、styles、layouts)、业务逻辑层(services、validators)、数据层(models、repositories、migrations)。适合传统 MVC/分层架构。
冲突避免规则
基本规则:一个文件只有一个负责人,任何文件都不应分配给多个实现者。
当文件必须共享时,可采取以下做法:指定单一负责人拥有该文件;其他实现者通过向负责人发送具体变更请求来提出改动;负责人按顺序应用变更以防止合并冲突。另一种方案是抽取接口:创建一个独立的接口文件,非负责人可导入该文件而无需修改它。
接口契约
当实现者需要在边界处协调时,可使用接口契约文件(例如 src/types/auth-contract.ts,由 team-lead 拥有,对实现者只读):
// src/types/auth-contract.ts (owned by team-lead, read-only for implementers)
export interface AuthResponse {
token: string;
user: UserProfile;
expiresAt: number;
}
export interface AuthService {
login(email: string, password: string): Promise<AuthResponse>;
register(data: RegisterData): Promise<AuthResponse>;
}
两个实现者都从契约文件导入,但都不修改它。
集成模式
垂直切片
每个实现者构建完整的功能切片(UI + API + 测试),例如 implementer-1 负责 Login 功能(登录表单 + 登录 API + 登录测试),implementer-2 负责 Register 功能。优点:每个切片可独立测试,集成需求最少。缺点:可能重复共享工具,功能紧耦合时较难。
水平分层
每个实现者负责所有功能中的一层,例如 implementer-1 负责全部 UI 组件,implementer-2 负责全部 API 端点,implementer-3 负责全部测试(单元、集成、端到端)。优点:每层内模式一致,自然形成专业化。缺点:集成点更多,第三层依赖前两层。
混合
根据耦合程度混合使用垂直与水平方式,例如 implementer-1 负责 Login 功能(垂直切片),implementer-2 负责共享认证基础设施(水平,如 middleware、JWT utils、types)。适合大多数含共享基础设施的真实功能。
使用方式
分支管理
单分支策略:所有实现者工作在同一个功能分支上。设置简单,无合并开销;需要严格的文件归属以避免冲突。适合小型团队(2-3 人)和边界明确的场景。
多分支策略:每个实现者在子分支上工作,例如:
feature/auth
├── feature/auth-login (implementer-1)
├── feature/auth-register (implementer-2)
└── feature/auth-tests (implementer-3)
隔离性更强,合并点明确;开销更高,共享文件中仍可能出现合并冲突。适合较大团队(4 人以上)和复杂功能。
故障排查
实现者互相阻塞等待共享代码:把共享部分抽取为独立的接口契约文件,由 team-lead 拥有,各实现者只导入而不修改契约。
即使有明确归属规则仍出现合并冲突:可能某文件被分配给两个智能体,或自动导入全部内容的配置/索引文件(如 index.ts、init.py)被双方修改。为所有 barrel/index 文件指定一个负责人,或由 lead 在最后统一合并。
某实现者提前完成但集成步骤受阻:使用暂存接口——已完成的实现者为下游依赖编写 stub 或 mock,让另一个实现者继续工作,集成时替换为真实实现。
功能分解中途发现错误:停止新工作,由 lead 重新分配文件并通过广播传达变更。部分已写代码的沉没成本可以接受,继续使用错误拆分更糟。
一个实现者写的测试在另一个实现者的代码上失败:接口契约发生漂移,拥有 API 的实现者未通知测试实现者就改了签名。应强制规定契约文件修改前必须广播。
相关技能
team-composition-patterns:在分解工作前选择合适的团队规模与智能体类型。 team-communication-protocols:协调实现者之间的集成交接与计划审批。
适用场景与限制
适用于多智能体协作开发中的功能分解、所有权划分、接口设计与集成分工。使用前提是存在明确的文件归属安排与契约约定;若团队规模很小或功能高度耦合,需谨慎选择集成与分支策略。资料未提供本技能的具体安装命令、支持的平台、收费方式或性能数据。