如何把多仓库根目录注册为 Archon 的 folder project 并跨仓库执行任务【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon如果你的项目不是一个单独的 git 仓库而是一个根目录下放着 N 个服务仓库的结构auth-service/、billing-service/等且根目录本身通常没有 git那么普通的 repo project 模式无法直接套用。Archon 把这种结构建模为folder project只注册一次根目录之后所有 workflow 和 chat 默认在该根目录下就地运行in placeagent 在一次运行中就能看到并操作所有子仓库。本文基于 Multi-Repo Projects 指南 和 Core Concepts 中的 Folder Projects 一节给出从注册根目录到跨仓库执行任务、再到验证范围的完整操作路径。准备条件已安装 Archon并且能执行archon version确认版本安装方式见 Installation。已安装并认证 Claude Code——Archon 编排 Claude Code 但不捆绑它编译版二进制需要设置CLAUDE_BIN_PATH见 Quick Start 的前置条件。手上有一个多仓库根目录目录下有多个子服务仓库根目录本身不是 git 仓库。文档中的示例根目录是~/platform你执行时替换为自己的根目录。第一步用--folder注册根目录并首次运行在多仓库根目录下给任意一个 workflow 命令加上--folder参数。首次运行即完成 folder project 的注册之后从根目录下任意位置运行都不再需要该参数cd ~/platform # 含 auth-service/、billing-service/ 等 —— 根目录本身不是 git 仓库 archon workflow run assist --folder List every service and its current branch文档示例输出首次运行会同时显示注册与运行模式# → Registered folder project platform (~/platform) # → Folder project — running in place (no worktree isolation).两条关键信息Registered folder project platform (~/platform)根目录已被注册为名为platform的 folder projectrunning in place (no worktree isolation)folder project 默认就地运行不做 worktree 隔离这就是跨仓库场景的预期行为。如果只是想核对当前有哪些可用 workflow可以先运行archon workflow list见 Quick Start。其他注册入口等价任选其一除 CLI 的--folder外文档给出另外两种等价注册方式见 Folder ProjectsChat 中注册/register-project platform ~/platform——非 git 路径会被自动识别为 folder命令说明见 Commands 参考。Web 控制台在Add Project中填写路径path字段。三者效果一致根目录成为一等 Archon project拥有独立的身份、per-project 环境变量、运行历史和命名化的 artifact/log 存储。第二步跨仓库执行任务注册完成后跨仓库工作的机制是agent 的工作目录就是根目录因此它可以在一次运行中cd进任意子仓库、跨服务读取代码、做协调性修改每个服务仓库内的 git 操作建分支、提交、推送、开 PR是 agent 的职责。Archon 不会为 folder project 创建 worktree也不管理分支/PR——你需要在 workflow 的输入里明确指示 agent 对每个服务执行这些 git 操作例如“每个服务分别建分支提交并开 PR”。一个跨仓库修改任务的运行方式与 repo project 类似只是不带--folder已注册cd ~/platform archon workflow run assist 给 auth-service 和 billing-service 各建一个分支修复 X 并在两个仓库分别提交、开 PR运行产生的 artifacts 和 logs 存储在~/.archon/workspaces/_folder/slug/下slug为项目名而不是 repo project 的owner/repo/路径per-project 环境变量的配置方式与 repo project 完全相同。验证确认注册范围与在 scope 内的仓库用以下两种方式列出该 folder 下包含的 git 仓库以确认哪些仓库在操作范围内Chat 中的/status命令archon doctor。文档示例输出Contains 20 git repos: auth-service, billing-service, … (10 more)以仓库数量和名字是否符合预期来判断注册范围是否正确。限制与替代路径folder project 有明确的边界执行跨仓库任务前需要知道--branch和--from参数会被拒绝/worktree命令报告 not applicable——folder project 没有可创建的 worktreeArchon 不提供跨子仓库的“组合式”多仓库 worktree 和自动 PR 流git 协调完全由 agent 完成文档说明未来可能有新的 isolation backend。可选分支——单个服务需要每次运行独立隔离不要把父目录的某个服务硬塞给 folder 模型而是把该服务仓库单独注册为 repo project再在它自己的目录里带--branch运行获得每次运行独立的 worktree 与自动 PR 流cd ~/platform/auth-service # 一个真实的 git 仓库 archon workflow run implement --branch fix-auth Fix the token refresh bug # → 普通 repo project隔离的 worktree 分支不需要 --folder两种模型可以组合使用根目录保持 folder project 用于跨服务工作个别服务单独注册为 repo project 用于单服务的运行级隔离。可选分支——不直接写入实时根目录默认就地运行意味着运行中的写入会触碰 live 根目录。如果希望写入不直接落盘可加--container或在配置中设置container.enabled改为在 overlay 隔离的 Docker 容器中运行详见 Container isolation guide。不适用的场景文档明确列出不适合 folder project 的两类需求期望Archon 统一管理跨子仓库的分支/PR——目前不存在这种组合式隔离后端期望某个仓库每次运行都隔离——应把该仓库本身注册为 repo project而不是注册父文件夹。【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考