SuperAPI AI 工具集

parallel-feature-development

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

用途

Parallel Feature Development 是一套用于协调多智能体并行功能开发的策略集合。它的目标是把一个功能拆解为多个可并行推进的工作流,在多个实现者智能体之间建立清晰的文件所有权边界,避免冲突,并规划结果的集成方式。

主要能力

文件所有权策略

技能提供三种划分文件所有权的方式:

  • 按目录:为每个实现者分配特定目录,例如 implementer-1 负责 src/components/auth/,implementer-2 负责 src/api/auth/,implementer-3 负责 tests/auth/。适合目录边界清晰的代码库。
  • 按模块:按逻辑模块分配所有权(模块可能跨目录),例如认证模块(登录、注册、登出)与授权模块(角色、权限、守卫)。适合面向功能的架构或领域驱动设计。
  • 按分层:按架构层分配,例如 UI 层、业务逻辑层、数据层。适合传统 MVC 或分层架构。

冲突规避规则

核心规则是“一个文件只有一个所有者”,任何文件都不应分配给多个实现者。当文件确实需要多方修改时,技能给出两种处理方式:指定单一所有者,其他实现者向所有者提出具体修改请求,由所有者顺序应用变更;或者抽取接口,创建一个独立的接口文件供非所有者导入,而无需修改原文件。

接口契约

当实现者需要在边界处协调时,可以创建由团队负责人拥有、对实现者只读的契约文件。示例中定义了 AuthResponse 与 AuthService 接口,两个实现者都从契约文件导入,但都不修改它。

集成模式

技能提供三种集成模式:

  • 垂直切片:每个实现者构建完整的功能切片(UI + API + 测试),例如登录功能与注册功能。优点是每个切片可独立测试、集成需求少;缺点是可能重复共享工具,对紧耦合功能较难。
  • 水平分层:每个实现者构建所有功能中的某一层,例如所有 UI 组件、所有 API 端点、所有测试。优点是层内模式一致、便于专业化;缺点是集成点更多,第三层依赖前两层。
  • 混合:根据耦合程度混合使用,例如登录功能用垂直切片,共享认证基础设施用水平分层。适合大多数包含共享基础设施的真实功能。

分支管理

  • 单分支策略:所有实现者在同一功能分支上工作,设置简单、无合并开销,但需要严格的文件所有权。适合 2-3 人小团队、边界明确的情况。
  • 多分支策略:每个实现者在子分支上工作,例如 feature/auth-login、feature/auth-register、feature/auth-tests。隔离性更强、合并点明确,但开销更高,共享文件仍可能冲突。适合 4 人以上团队或复杂功能。

问题排查

技能还列出常见问题及应对:实现者互相等待共享代码时,可抽取共享接口契约文件;即使有明确所有权仍出现合并冲突时,通常是文件被分配给两个智能体,或 barrel/index 文件被双方修改,应指定单一所有者或由负责人最后合并;实现者提前完成但集成被阻塞时,可使用暂存接口(stub 或 mock);功能拆解中途发现错误时,应停止新工作、由负责人重新分配文件,并逐个发送定向消息通知;测试与代码不匹配时,通常是接口契约漂移,应强制要求修改契约文件时通知所有依赖方。

使用方式

该技能以策略和规则的形式提供,供多智能体开发流程参考。具体调用方式、安装命令或工具集成方式暂未提供。

适用场景

  • 将功能拆解为并行实现任务
  • 在智能体之间建立文件所有权边界
  • 为并行工作流设计接口契约
  • 选择集成策略(垂直切片或水平分层)
  • 管理并行开发的分支与合并工作流

限制

资料未提供该技能的具体运行环境、依赖、安装方式、收费模式或效果保证。相关技能包括 team-composition-patterns(在拆解工作前选择团队规模与智能体类型)和 team-communication-protocols(协调集成交接与计划审批)。