SuperAPI AI 工具集

parallel-implementation

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

parallel-implementation 是一个规划(planner)技能,只产出切片计划,不自行调用子代理,主 Agent 保留执行权。适用触发条件:多模块的 0→1 新项目,可按数据/服务/UI 分层并行;改动涉及至少 3 个模块(主 Agent 应用 AskUserQuestion 与用户确认是否并行);改动涉及至少 5 个文件且每个文件 diff 超过 50 行;或用户明确要求“并行写”“多 agent 并行实现”“拆给子代理”。不适用:单文件或 2 到 4 个文件、单切片 diff 小于 50 行;所有调用方从单点变更级联的重构;存在串行依赖(B 依赖 A 输出);纯读取任务。

核心铁律:只有每个切片的输入与输出彼此独立,计划才有效;若两切片可能在同一文件、共享数据结构或共享执行中状态上冲突,必须合并为一个写入者或串行化。步骤:1)切片可行性检查,不成立则返回 serialize;2)草拟文件分配,列出每个切片创建/修改/删除的文件、所需输入与产出;3)碰撞检查并合并冲突切片;4)体量过滤,单切片小于约 50 行交由主 Agent 内联,约 50–150 行为候选,超过 150 行或架构性任务派发;过滤后不足 3 个可派发切片则返回 serialize;5)为每个切片约定输出格式(如统一 diff 加逐文件一句话理由、完整新文件加角色说明、测试文件加需求映射列表)并指定验证方式(如 npm test -- path、tsc --noEmit、构建、最小冒烟测试);6)返回含切片、写入者、模型、文件、依赖、输出格式、验证的表格,并标注可并行、受门控与内联切片。模型列默认 inherit,仅在有理由时写中性覆盖描述(如更强推理模型、xhigh 努力、快速机械模型),不硬编码厂商模型名。主 Agent 收到计划后执行:并行切片在单条消息中发起多个带 worktree 隔离的 Agent 调用,门控切片待依赖完成后由主 Agent 中转,内联切片自行编写。限制:当前 CLI 运行时没有代理间通道,不能靠共享状态协调;派发含“让测试通过”约定的切片时应加反硬编码质量约束;输出格式缺失会导致子代理回灌冗长上下文。