SwarmForge项目结构：组织你的AI代理工作目录
【免费下载链接】swarm-forgeA simple tool for coordinating several AI agents.项目地址: https://gitcode.com/GitHub_Trending/sw/swarm-forge
SwarmForge是一个基于tmux的AI代理协调平台，能够将多个AI代理转变为可靠的专业软件工程师团队。本文将详细解析SwarmForge的项目结构，帮助新手用户快速理解如何组织AI代理的工作目录。
核心目录结构
SwarmForge采用模块化设计，主要目录结构如下：
swarmforge/ constitution/ articles/ engineering.prompt handoffs.prompt workflow.prompt scripts/ terminal-adapters/ ghostty.sh iterm2.sh none.sh terminal-app.sh windows-terminal.sh done_with_current.sh ready_for_next.sh swarmforge.sh handoff-protocol.md swarmforge.confconstitution 目录
constitution 目录是SwarmForge的"宪法"中心，包含了AI代理需要遵循的各种规则和指导方针。其中：
engineering.prompt：包含工程规则，如启动工具、语言默认值、设计和可测试性等handoffs.prompt：定义了AI代理之间的交接规则，包括发送和接收交接的具体流程workflow.prompt：规定了工作流规则，如工作树规范、公告、提交消息格式等
这些文件共同构成了AI代理的行为准则，确保整个团队能够高效协作。
scripts 目录
scripts目录包含了SwarmForge的核心脚本，用于启动、管理和协调AI代理：
swarmforge.sh：主启动脚本，负责初始化和启动整个SwarmForge系统- 交接相关脚本：如
done_with_current.sh、ready_for_next.sh等，用于管理任务的接收和完成 - terminal-adapters：终端适配器脚本，支持不同终端类型如Ghostty、iTerm2等
这些脚本为AI代理提供了必要的工具和接口，使其能够相互通信和协作。
配置文件详解
swarmforge.conf
swarmforge.conf是SwarmForge的核心配置文件，定义了整个swarm的窗口结构。每行格式如下：
window <role> <agent> <worktree> [task|batch] [extra-cli-args...]例如：
window coordinator codex master window coder codex coder window refactorer codex refactorer window architect codex architect这个配置定义了四个角色：coordinator、coder、refactorer和architect，每个角色使用不同的工作树，确保它们可以并行工作而不会相互干扰。
handoff-protocol.md
handoff-protocol.md详细描述了AI代理之间的交接协议，包括目录布局、文件名格式、文件格式和消息类型等。这个协议确保了AI代理之间能够可靠地传递任务和信息。
交接协议定义了两种主要消息类型：
git_handoff：用于角色之间提交工作成果note：用于发送简短的自由格式消息
工作树结构
SwarmForge使用git工作树来隔离不同AI代理的工作空间。每个角色都有自己的工作树，位于.worktrees/目录下：
.worktrees/ coder/ refactorer/ architect/这种结构确保每个AI代理可以独立工作，同时又能通过交接协议进行协作。
分支策略
SwarmForge采用特定的分支策略来支持不同的工作流程：
two-pack：快速后端工作流，包含coder和cleaner两个角色four-pack：紧凑规范工作流，包含specifier、coder、refactorer和architect四个角色six-pack：完整工作流，包含specifier、coder、cleaner、architect、hardender和QA六个角色
用户可以根据项目需求选择合适的分支，从而获得最佳的AI代理协作配置。
快速开始
要开始使用SwarmForge，只需执行以下命令：
BRANCH=four-pack curl -L "https://github.com/unclebob/swarm-forge/archive/refs/heads/${BRANCH}.tar.gz" | tar -xz --strip-components=1 ./swarm这将下载并启动指定的工作流分支，自动创建必要的工作树和配置。
总结
SwarmForge的项目结构设计精巧，通过模块化的配置和脚本，以及清晰的工作树隔离，为AI代理提供了一个高效协作的平台。理解这些结构将帮助用户更好地配置和管理AI代理团队，充分发挥SwarmForge的潜力。无论是小型项目还是大型工程，SwarmForge都能提供灵活而强大的AI代理协调解决方案。
【免费下载链接】swarm-forgeA simple tool for coordinating several AI agents.项目地址: https://gitcode.com/GitHub_Trending/sw/swarm-forge
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
