用途
meta-repo 技能用于在管理多仓库系统时调用 meta 工具(github.com/mateodelnorte/meta)。它把单仓库与多仓库两种模式结合起来:meta 仓库是一个轻量 git 仓库,只存放编排产物(.meta 配置、可选根 package.json、docker-compose.yml、Makefile 等),其中 .meta 文件以 JSON 列出各子仓库路径与远端地址;子仓库位于配置的路径下,是彼此独立的 git 仓库,拥有自己的远端、分支和历史,meta 仓库本身不跟踪子仓库文件。
主要能力
- 一条命令克隆整个多仓库项目:meta git clone <url>,会克隆 meta 仓库及其所有子仓库。
- 跨所有子仓库执行 git 命令,如 status、pull、checkout。
- 对每个子仓库执行任意 shell 命令:meta exec,支持 --parallel 并行执行。
- 跨仓库执行 npm/yarn 命令,如安装、运行测试脚本。
- 添加或导入子仓库:meta project create 与 meta project import,两者会自动更新 .meta 与 .gitignore。
- 将单仓库迁移为 meta 多仓库结构:meta init 后用 meta project migrate 逐个迁出目录。
- 通过 --include-only 和 --exclude 将命令限定到部分仓库(底层由 loop 提供过滤能力)。
- 拉取新配置后用 meta git update 克隆 .meta 中新增的子仓库。
- 插件架构:每个子命令由名为 meta-<plugin> 的 npm 包贡献,核心插件包括 meta-init、meta-project、meta-git、meta-exec、meta-npm、meta-yarn,也可扩展以包装其他 CLI 工具。
使用方式
安装与初始化:
npm i -g meta
mkdir my-meta-repo && cd my-meta-repo && git init
meta init
添加子仓库:
meta project create services/api git@github.com:yourorg/api.git
meta project import packages/ui git@github.com:yourorg/ui.git
meta git clone git@github.com:yourorg/my-meta-repo.git
.meta 文件为纯 JSON,含一个 projects 映射(本地路径到 git 远端 URL):
{
"projects": {
"services/api": "git@github.com:yourorg/api.git",
"packages/ui": "git@github.com:yourorg/ui.git"
}
}
常见操作示例:
meta git status
meta git pull
meta exec "npm ci"
meta exec "npm run build" --parallel
meta npm install
meta git status --include-only services/api,services/worker
meta exec "npm run lint" --exclude packages/legacy
meta git update
适用场景
适合以下情形:用户要一条命令克隆整个多仓库项目;需要在所有子仓库上运行 git 命令;要对每个仓库执行任意 shell 命令;需要用 meta project migrate 从单仓库迁移到多仓库;需要跨仓库批量执行 npm install 或 yarn;需要向 meta 项目添加或导入子仓库;需要为新开发者讲解多仓库架构接入;需要把命令过滤到部分仓库。
限制与注意事项
- 不适用于由 Turborepo 或 Nx 管理的单仓库构建,也不用于跨多仓库的 Docker/容器编排。
- meta 未全局安装时会报 command not found,需执行 npm i -g meta。
- 子仓库目录虽写入 .gitignore,但如果手动编辑 .meta 而未使用 meta project 命令,对应路径不会被加入 .gitignore,子仓库内容会出现在 meta 仓库的 git status 中;应尽量使用 meta project create/import。
- meta git clone 需要当前用户对所有子仓库都有 SSH 访问权限,任一仓库无权限都会导致克隆失败,且错误在并行输出中不易发现。
- meta exec 中的 shell 变量会在 meta 上下文展开而非子仓库上下文,如 meta exec "echo $PWD" 会让每个子仓库打印相同路径,需转义为 meta exec "echo $PWD"。
- meta git update 只克隆缺失仓库,不执行拉取;更新已有仓库需另外运行 meta git pull。
- 插件需全局安装,仅放在 devDependencies 中可能导致命令找不到。
技能参考资料 references/commands.md 提供各子命令完整参数说明,在用户询问具体参数时可查阅。若配置中列出了 recommended_skills,技能会在对话中首次激活时检查已安装的伴随技能,并提示用 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name> 安装缺失项。官方文档中的收费、价格等信息暂未提供。