Concitech AI · 深度长文
2026/11/16 11:00
Matt Pocock提出Home Repo!Agent多仓库协作有了“总部”,评论区点出边界
Home Repo保存共享规则、技能和跨仓库文档,目录指针连接业务仓库。推文评论补充了本地规则、入口选择、worktree与规则加载等问题。本文梳理这种组织方式的用途与工程边界,资料来源包含作者原文、评论和官方文档。

一次需求,涉及前端、接口和支付三个仓库。Agent的工作入口,属于哪一层?
Matt Pocock的答案叫Home Repo:一个保存共享技能、规则与文档的仓库。Agent会话的起点是这个仓库,AGENTS.md提供其他仓库的路径与用途说明。[1]
作者的配套文章《The Home Repo Pattern》,给出了完整的组织思路。业务代码、Git历史和发布流程,属于各个业务仓库;Home Repo承担共享知识与导航职责。[1]
这条推文下的几组公开评论,补充了一个问题:共享知识的入口,与修改代码的工作范围,怎样配合?
一个“总部”,连接多个业务仓库
多仓库项目具有共同知识:编码规范、术语、跨服务决策和团队技能。每个项目保存一份副本,维护工作产生了重复。
Home Repo提供一个共享资料库,仓库索引记录各项目的位置、职责和查阅入口。团队获得一套具有版本记录的协作材料。[1]
示意结构如下:
workspace/
├── team-home/ # 共享资料仓库
│ ├── AGENTS.md # 导航与通用约定
│ ├── skills/
│ ├── docs/
│ └── tasks/
├── web-app/ # 前端仓库
├── service-api/ # 接口仓库
└── payments/ # 支付仓库
monorepo统一代码仓库,Home Repo连接独立仓库。两者采用不同的代码组织方式。[1]
这个结构提供导航关系。前端、接口和支付仓库具有各自的代码、测试与提交记录。Home Repo的任务文档描述跨仓库依赖,业务仓库的提交承载具体修改。

图:仓库职责的概念示意。资料来源:作者文章、本地规则讨论与Git文档。[1][2][5]
评论补充:本地规则需要自己的位置
Matias Poblete的评论建议,各仓库保留一份简短的AGENTS.md,内容包含构建脚本、lint规则和修改边界。Matt的回复是赞同。[2]
这项补充形成了两层职责:Home Repo记录共同约定,业务仓库记录本地事实。
一条支付接口的测试命令、一组前端生成文件的限制,具有具体项目的适用范围。它们的维护者、变更节奏和验收方式,需要对应项目的支撑。
“新增企业账单导出”是一项示意需求:
| 位置 | 修改对象 | 验收依据 |
|---|---|---|
| 前端仓库 | 导出入口与状态反馈 | 页面行为与错误提示 |
| 接口仓库 | 导出任务与状态接口 | 接口契约与测试 |
| 支付仓库 | 账单数据与业务口径 | 字段定义与结果核对 |
Home Repo中的任务说明,记录三个仓库的依赖、提交和验收结果。单个仓库的操作细节,属于本地规则文件的内容。
另一种入口:业务仓库启动,查阅共享资料
Arty提出了相反的使用经验:Agent的起点是隔离的业务仓库,仓库中的指针指向Home Repo的相关章节。他表示,Home Repo入口方案出现过无关仓库探索。Matt回应,这个想法值得考虑。[3]
这是使用者经验,缺少统一的对照实验。它提出了一项可选设计:共享资料的位置,与Agent的启动目录,具有不同的职责。

图:原帖方案与评论方案的路径示意。资料来源:原帖与Arty评论。[1][3]
跨服务需求需要系统视图,单仓库修复需要明确范围。前者适合统一的导航入口,后者适合业务目录与共享资料指针的组合。
这是任务组织的选择。一个入口的便利程度,需要具体任务的检验。
worktree提供工作副本,Home Repo组织共享知识
并行开发问题出现在另一组评论中。Matt建议,每个仓库的clone配合worktree。另一位使用者提到,遗留worktree占满了磁盘;作者的回复是清理。[1]
Git官方文档说明,一个仓库支持多个工作树。不同工作树具有各自的工作目录与检出状态,部分仓库管理数据构成共享资源。[5]
Home Repo、业务仓库和worktree,构成三个层次:共享资料、代码归属、任务工作副本。
worktree的验收与清理,需要提交状态、未跟踪文件和保留资料的检查。worktree list列出工作树,worktree remove移除干净的工作树,worktree prune清理失效的管理记录。[5]
并行任务的编辑隔离需要工作副本,跨仓库交付需要提交与依赖记录。一个共享资料仓库承担知识组织,执行环境承担代码修改。
目录指针、规则加载和权限,是三件事
Browser OS的评论提醒,Claude Code的额外目录访问与规则文件加载具有区别。[4]
2026年11月16日的官方文档核查结果是:--add-dir提供额外目录访问;额外目录的CLAUDE.md加载采用独立的环境变量开关。官方文档提供了CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1这一配置。[4]
当前文档包含AGENTS.md支持说明,其加载条件涉及版本、项目设置和目录位置。额外目录的AGENTS.md属于这一环境变量开关的覆盖例外。[4]
**目录索引提供位置,规则加载提供上下文,工具权限控制访问范围。**文件存在、Agent读取了文件、Agent获得修改权限,属于不同状态。
Home Repo的价值,是一份可维护的协作地图
这场讨论形成了一套职责划分:共享知识需要版本管理,本地事实需要项目维护,任务执行需要工作副本,结果交付需要验收记录。
我的判断是,Home Repo适合承担团队的协作地图。它的价值来自导航质量、规则归属和任务记录。模型处理跨仓库需求,需要这些材料的支撑。
一份可用的地图,说明目标仓库的位置、各仓库的职责、当前任务的范围和完成判据。工程团队的工作,是维护这份地图与实际项目的对应关系。
