Vibecoding General 是一个通用型多智能体编码编排技能,定位为“设计优先”的软件开发工作流,用于构建通用软件项目。它覆盖 Python 工具、数据管道、机器学习系统、API、游戏、机器人、命令行应用、移动应用以及任何非前端编码任务。
核心原则
规格优先:在开始任何实现之前,先编写规格文档(SPEC.md)。该文档是架构、模块、接口和数据流的唯一事实来源。
规格忠实:子智能体必须忠实实现 SPEC.md,包括精确的接口、精确的模块边界、精确的数据格式,不得单方面更改。
主智能体负责初始化、合并与集成;子智能体在自己的分支上实现并提交。
按模块与功能并行:每个子智能体负责一个或多个模块/功能。将相关工作归入同一个智能体,以尽量减少跨智能体依赖。
Git worktree 隔离工作:每个子智能体在自己的 git worktree 中工作,避免冲突。共享仓库是协调中心。
接口契约神圣不可侵犯:在规格中定义函数签名、数据模式和文件格式。子智能体按这些契约实现,使模块能够干净地集成。
合并前测试:每个子智能体在提交前运行自己模块的测试。主智能体在合并后运行集成测试。
模式选择
任务包含 3 个以上不同模块或组件时,使用模式 A(多智能体)。 任务同时涉及基础设施和应用逻辑时,使用模式 A(多智能体)。 任务是一个完整系统(如 API + 工作进程 + 数据管道等)时,使用模式 A(多智能体)。 任务是一个单一脚本、工具或聚焦功能时,使用模式 B(单智能体)。 任务是缺陷修复或小型增强时,使用模式 B(单智能体)。 不确定时,使用模式 B(单智能体)。
Worktree 参考
Git worktree 允许多个智能体同时在同一仓库上工作而不产生冲突。
设置(每个子智能体):
cd /mnt/agents/output/project # 共享仓库 git worktree add $HOME/work-<branch> <branch> # 创建本地 worktree cd $HOME/work-<branch> # 在此工作
规则:
每个子智能体必须使用唯一的 worktree 路径($HOME/work-<branch>)。
永远不要运行 git worktree prune——它会破坏其他智能体的 worktree 条目。
永远不要直接在 /mnt/agents/output/project 中工作——始终使用 worktree。
在 worktree 中提交后,主智能体从共享仓库进行合并。
清理(主智能体,在所有合并完成后):
cd /mnt/agents/output/project git worktree remove $HOME/work-<branch> # 可选,按分支执行
文件布局
/mnt/agents/output/ ├── SPEC.md # 项目规格(唯一事实来源) ├── info.md # 研究发现(如适用) ├── project/ # 共享 git 仓库(协调中心) │ ├── .git/ │ └── ... # 按 SPEC.md 的项目结构 │ $HOME/work-<branch>/ # 本地 worktree(每个子智能体唯一) └── ... # 相同结构,隔离的工作副本
适用场景与限制
该技能适用于需要多模块协作的通用软件项目,尤其是同时涉及基础设施与应用逻辑、或由 API、工作进程、数据管道等组成的完整系统。对于单一脚本、工具、聚焦功能、缺陷修复或小型增强,建议使用单智能体模式。使用该技能需要具备 git worktree 环境,并遵循规格优先、接口契约和测试先行的流程。关于收费、价格、平台支持范围等具体信息,资料中暂未提供。