教程2026-11-13 · 智涌AI

Home Repo 怎么搭:一个仓库让 Agent 管多个仓库

Home Repo 教程头图:左侧大字「Home Repo 多仓库 Agent」与 20 个仓库、400 个仓库、4 步数据卡;右侧终端窗口显示 AGENTS.md 里 Other Repos 一节,每个仓库一行路径和克隆地址

一个功能要改前端、后端和支付服务三个仓库,编程 Agent 从其中一个仓库启动,就只看得见这一个仓库;Skills 和 AGENTS.md 也在每个仓库各存一份,越改越不一致。教程站 AI Hero 上有篇文章介绍了一种叫 Home Repo 的做法:单独建一个仓库放 Skills、AGENTS.md 和共享文档,Agent 从这里启动,再按指针去打开或克隆其他仓库。这篇按原文讲清它放什么、怎么搭、规模大了怎么办。

Home Repo 只放跨仓库通用的东西

按原文的定义,Home Repo 是一个普通 git 仓库,里面放三类东西:多个仓库都用得上的 Skills、带导航指针的 AGENTS.md、共享文档。共享文档里最先值得搬进来的是编码规范,一套通用规范可以跨项目复用;术语表、影响整个系统的架构决策(ADR)、一个小型 Markdown wiki、团队工具也可以放。

代码不搬。每个仓库保留自己的历史、远端和 issue 跟踪,也保留只对自己成立的内容:它自己的 AGENTS.md、构建和测试命令、仓库专属文档。

内容放哪
多个仓库通用的 Skills、编码规范、术语表Home Repo,只留一份
同一份内容在多个仓库各有副本比对后取最新版,搬进 Home Repo
某仓库自己的 AGENTS.md、构建测试命令留在该仓库
从 Skills 仓库或市场安装的 Skill保持安装,不复制
业务代码、git 历史、issue原仓库不动

为什么不直接放进 ~/.claude/skills 这类用户目录?原文的回答是:理想状态是所有人用同一套 Skills、跟着项目走,用户目录只是过渡;Home Repo 是一个项目,Skills 有 git 版本,团队也能共享。

导航指针一行一个仓库

Home Repo 的 AGENTS.md 先写一小段介绍,再加一节「Other Repos」,每个仓库一行:名字、是什么、本地路径、缺失时从哪克隆,需要时加一句提示。原文示例:

## Other Repos

Storefront (Next.js app): ~/repos/acme/storefront. Clone from git@github.com:acme/storefront.git if missing.
Payments API: ~/repos/acme/payments-api. Read its AGENTS.md before changing it.
AI Hero: ~/repos/ai/ai-hero (git pull to view latest, likely out of date)

Agent 看到指针后,路径下已有仓库就直接在那里干活,没有就克隆到那个路径。也有人把子仓库克隆进 Home Repo 再加进 .gitignore。会话从 Home Repo 启动,跨仓库的功能也在这里先讨论清楚。

用哪个文件名取决于你的工具在会话开始时加载什么。原文统一写 AGENTS.md,Claude Code 加载的是 CLAUDE.md,这时可以让 CLAUDE.md 只写一行,指向 AGENTS.md。

代码留在原仓库,Agent 从 Home Repo 出发,按一行一行的指针找到要改的地方。

第一步:准备一个新会话

前置条件很少:一个能读文件、跑 git 的编程 Agent(Claude Code、Codex 之类),你的各个仓库都克隆在同一个父目录下;想查远端和可见性的话,装好并登录 gh。在这个父目录里开一个新会话。

第二步:把原文提示词贴进去

原文给了一段完整提示词,核心规矩有四条:事实让 Agent 自己查(文件系统、git、gh,大范围搜索用子 Agent),只把需要拍板的事带给你;问题分轮问,每题编号并给出推荐答案,回「yes」就算接受;第 3 步方案获批之前只读不写;.env 等密钥文件不读。下面是它的流程骨架(完整原文见文末来源):

Step 1 盘点仓库:找出家目录下所有 git 仓库(跳过依赖目录),
  记录路径、远端、公开/私有、最后提交日期。
  第一轮问:纳入哪些仓库;Home Repo 放哪、新建还是复用;
  个人用还是团队共用;会话启动加载 AGENTS.md、CLAUDE.md 还是都要。
Step 2 盘点共享材料:列出所有 Skill(含 SKILL.md 的文件夹)、
  AGENTS.md / CLAUDE.md、给 Agent 看的文档,
  归入 shared / duplicate / repo-specific / installed 四类之一。
Step 3 确认方案:一张表列出每项现在在哪、要去哪,
  附上 Home Repo 的 AGENTS.md 草稿,你批准后才进入下一步。
Step 4 执行:建仓库和 AGENTS.md;复制共享项(Skill 文件夹整体复制);
  在每个子仓库新开本地分支删掉已迁走的副本;在 Home Repo 提交。
  推送由你决定。

几个设计值得照抄:每一步都写了「完成标准」,比如第 2 步要求每一项恰好归入一类;子仓库的删除放在新分支上做,不碰主分支;最后要求 Agent 逐行汇报表里每一项的结果、建了哪些分支、跳过了什么以及原因。

第三步:审方案时重点看三处

仓库多了,指针要分层

原文给的经验数:20 个左右的仓库,一个仓库一行没问题;到 400 个左右,一行一个仓库对 Agent 来说要做的选择太多,改成按业务领域分文件,AGENTS.md 只指向这些文件:

## Other Repos

Billing (invoices, payments, tax): see repos/billing.md
Storefront (web and mobile apps): see repos/storefront.md
Internal tools: see repos/internal.md

到几千个仓库,Skills 的使用方太多,原文认为这时做一个 Skills 市场更合适(团队内分发 Skills 的做法可以看团队共享 Agent Skills)。

和其他方案的关系:能用 monorepo 就用 monorepo;公开和私有仓库混在一起、或者团队不肯迁 monorepo 时,用 Home Repo 顶上。5 到 10 个仓库用 git submodule 也行,纯指针能做同样的事,省掉 submodule。

多个 Agent 同时改一个仓库时,原文的做法是每个仓库只克隆一次,每个功能在这份克隆里开一个 worktree(worktree 的清理习惯见 git worktree 教程)。CI 或自动化流水线里也能用:把 Home Repo 放进沙箱,需要哪个仓库再克隆。

常见坑

完成标准

最后

先拿两三个常一起改的仓库试:建 Home Repo,写好指针,搬一份编码规范进去,下次跨仓库的需求从这里开会话,看 Agent 能不能一次找全要改的地方。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。