📌 项目地址:Tencent/teamai-cli | ⭐ 2,849 颗星 | 🔧 TypeScript | 📜 未标注
一个真实的痛点
团队里每个人选的 AI 编程工具不一样:有人用 Claude Code,有人用 Cursor,有人用 Codex。问题来了——团队沉淀的 skills、rules、MCP 配置、hooks,怎么下发到每个人手里的 agent 上?
现状通常是:某个老手精心调好了自己 Claude Code 的规则文件,但这些经验只活在他本机。新人入职,配出来的 AI 行为和老手完全两样。团队规范在 AI 时代变成了“各凭缘分”。
Tencent/teamai-cli 解决的就是这个。目前 2849 star,TypeScript 写的,npm 全局安装。它的思路很直接:用 git 仓库作为团队 AI 资源的单一来源,把 skills、rules、docs、env、agents、hooks、MCP 统一管理,分发到 Claude Code、Codex、Cursor、CodeBuddy、WorkBuddy、OpenCode、Qoder、ZCode 等十多种 agent。
核心机制:git 仓库 + 自动同步
用法分两种角色。
管理员:在 GitHub、GitLab、GitCode、CNB、TGit 或私有 Git 服务上建一个共享仓库,给团队成员开写权限,然后:
teamai init https://github.com/yourorg/yourrepo
不想从零配置,可以去 teamai-hub 组织下找模板仓库——预置了生产可用的 skills、rules 和 review agents,点 “Use this template” 之后对新仓库执行 init。
成员:两种作用域:
# 项目级(默认),资源装在项目目录下
cd /path/to/my-project
teamai init https://github.com/yourorg/yourrepo
# 或用户级,资源装在 ~/ 下
teamai init https://github.com/yourorg/yourrepo --scope user
初始化之后,每次 AI 会话会自动拉取管理员发布的最新更新,不需要手动 sync。管理员改一条规则,成员下次开会话就生效——这个“改完即达”的链路是整个工具最有价值的部分。
三层架构,但只有一层能用
README 给出的产品架构分三层,需要分清楚哪些是现货、哪些是期货:
- Team Execution(已上线):init / pull / push,加上 skills、rules、agents、hooks、MCP、env 的管理。让每个 agent 按团队的方式干活。
- Team Context(beta):recall、learnings、codebase graph、teamwiki,目标是让 agent 理解团队上下文。
- Team Improvement(beta):friction-based share-learnings、sessions、digest、dashboard,目标是每次执行反过来沉淀团队知识。
兼容矩阵上,Claude Code、Codex、Cursor、CodeBuddy、Qoder 对全部三层能力支持;OpenCode 缺 Improvement 层;Hermes、DeepSeek Harness、ZCode 支持范围更窄。如果团队主力工具是矩阵里靠后的那几个,建议先确认覆盖情况。
用之前想清楚这几件事
写权限问题。README 明确要求给团队成员开共享仓库的写权限。在安全规范严格的公司,全员可写一个配置仓库这件事需要过一下安全评审。
beta 别当生产依赖。Context 和 Improvement 两层都标着 beta,核心可用的是 Execution 层。我建议先只用 Execution 层跑通 skills 和 rules 的分发,beta 功能观望。
git 托管支持偏国内友好。除了 GitHub / GitLab,还支持 GitCode、CNB、TGit 和私有 Git 服务。国内团队不用为托管平台发愁。
README 不完整。”Distribution Controls” 一节(管理员配置一次、全员生效的分发控制)在文档里被截断了,具体能力要看仓库里的 docs/usage-guide.md,有中英文两个版本。
我的判断
这个工具对准的场景很具体:多 AI 工具并存的团队,需要统一的工程规范下发。如果你的团队全员只用一个 agent,它解决的是伪问题;如果工具混杂(这在现实中非常常见),它把“每人一套配置”收敛成“一个仓库管所有人”,光这一点就值得试一下。
个人开发者也有个用法:用 user scope 把自己的 skills 和 rules 在多个 agent 之间保持一致,换工具不用重新配一遍。
安装一条命令:npm install -g teamai-cli。