每日文摘

深挖 · teamai-cli:腾讯开源的团队 AI 资产集线器,一个 git 仓库喂饱全队的 11 种 agent

题图

团队里有人用 Claude Code、有人用 Cursor、有人用 CodeBuddy,每人手里都攒着一撮好用的 prompt、skill 和踩坑经验——然后呢?散落在各自的 ~/.claude/ 和聊天记录里,人走了经验就没了。腾讯最近开源的 teamai-cli 冲的就是这个问题:用一个共享 git 仓库,把团队的 AI 资产统一沉淀、评审、分发到 11 种编码工具。star 三周从 389 涨到 2979,但 npm 周下载只有 1315——这中间的落差,正是本文要拆的。

是什么

先把最常见的误会澄清掉:teamai-cli 不是又一个 AI 编码工具,它不接任何模型。它的口号是 “Make Every Team AI Native”,定位是横跨多种 AI coding agent 的「团队配置与知识分发层」——把团队的 skills、rules、MCP 配置、hooks、知识文档集中到一个共享 git 仓库,经 MR 评审后自动分发到每个成员本地装的所有 AI 工具(README)。

产品分三层(README):

兼容矩阵覆盖 11 种 agent:Claude Code、Codex、Cursor、CodeBuddy、WorkBuddy、OpenCode、OpenClaw、Hermes、DeepSeek Harness、Qoder、ZCode(README 中文版)——Claude、OpenAI、国产路线全都在列,成员可以各用各的 agent,资产照样统一。一个小提醒:中英文 README 的名单不完全一致(英文版列 9 个),社区也建议引入前按自己的工具组合实测(zhangferry 评测)。

它和 Claude Code、Cursor 是互补而非竞争:Claude Code 本身就是 teamai-cli 的分发目标之一。它管的是各工具的配置注入点(hooks、CLAUDE.md/AGENTS.md、MCP 配置、子 agent 文件),自己不做编码 agent 循环(博客园 iTech 拆解)。

核心机制(技术)

一个 git 仓库就是团队 AI 资产的事实源。 数据分三区(usage-guide):知识资产(skills/rules/docs/learnings)放共享 repo 的 main 分支;会话统计等报告类推到独立的 orphan 分支,不污染主分支;机器本地数据(config、搜索索引)放 ~/.teamai/。所有 git 写操作都在隔离 worktree 里执行,不会碰你的工作树、也会跳过业务仓库的 husky/lint-staged 这类 hooks。

协作闭环:push → MR 评审 → 自动 pull。 任何变更(新增 skill、修改 rule、删除 MCP)都走 teamai push 建分支开 MR,reviewer 审批合并后,其他成员的 AI 会话启动时由 SessionStart hook 自动拉取分发——不需要谁喊一声「大家更新一下」(README)。分发粒度可控制:roles 让新人只拉 skills/backend/,tags 按标签订阅,source 还能订阅其他团队的公开 skill 仓库。

最有想象力的部分是经验自动回流。 会话结束时 Stop hook 会按「摩擦信号」打分:你是不是打断纠正了 AI、拒绝了某次工具调用、某个工具反复重试出错——「又长又顺的会话不会触发」,只有真踩坑的会话才提示你把经验总结成 learning 推到团队仓库(走 MR,每会话至多提示一次,可关)(README)。learning 不是直接变资产,有明确晋升门槛:confidence ≥ 0.90、至少 5 个 upvote、至少 2 个不同贡献者、入库满 14 天,满足后才 promote 为正式 skill/rule/doc(usage-guide)。配合 recall 召回(BM25 + 代码图谱加权重排,默认关闭)、maintenance 剪枝和 digest 周报(token 用量、会话量、干预率),构成一条完整的「沉淀 → 审核 → 召回 → 晋升 → 治理」生命周期。

工程质量值得一提:src/ 12 万行 TypeScript 里测试占 48%,单测 + e2e 双套,4.5 个月 695 commits、日均 5+,周级发版(GitHub API、contributors API)。但贡献者 34 人中第一名占了 534/695 commits(77%)——本质上是「腾讯一个小团队 + 1 个核心作者」驱动的项目,bus factor 不低。

横向对比(各家官方文档):Claude Code 的官方团队共享是把 .claude/skills/ 提交进版本控制 + 插件市场 + 企业 managed settings,绑定 Claude 生态(Skills 文档);Cursor 是 .cursor/rules 提交 git + Team/Enterprise 的云端 Team Rules,只管 Cursor(Rules 文档);Copilot 走组织指令 + 知识索引,绑定 GitHub。这些机制都只覆盖 teamai-cli 闭环的一小段,且都限定自家生态——跨 agent 中立 + git 控制面 + 经验回流闭环,是它的差异化所在。

怎么跑起来(环境)

数据说话(评测)

值不值得跟(团队 leader 决策指南)

如果你是团队 leader,关心的是那四个问题,这里直接给答案。

用法(半天能跑通)。 管理员在 git 平台建一个共享仓库(或直接从 teamai-hub 模板起步,内置成套 skills/rules/review agents),执行 teamai init <repo-url>;成员进入项目目录同样 teamai init 接入(--scope user 可装到 ~/ 跨项目生效)。之后所有变更走 MR、更新自动 pull,teamai status 看差异、digest 看周报、dashboard 看知识库健康度(README、usage-guide)。

引入后的成果。 团队的 prompt、skill、rule、MCP 配置、hooks、协作文化(culture.md)全部 git 化——可版本回溯、可审计、新人 clone 即得全套 AI harness;踩坑经验由摩擦信号自动触发回流,经评审晋升为正式资产;MCP「声明一次,自动转成每个工具的 native 格式」;digest/dashboard 给你干预率、token 用量、知识库覆盖率这些以前根本拿不到的度量(博客园 iTech)。iTech 的判断是「7 天内就应该能拿到真收益」——这是文档分析结论,不是实测。

是否建议使用?分情况,这是社区两篇最深评测的一致画像:

如何使用(分阶段路线,别一步到位)。 社区共识的节奏:第 0 步花 10 分钟——只同步 5-10 条 rules,先验证「改一处、全员生效」这个最小闭环;第 1 周——迁 skills/hooks/MCP,同时装上治理闸门(sharing.hooks.autoApply: false、requireTeamScripts: true、紧急开关 TEAMAI_HOOKS_DISABLED=1);第 2-4 周——再开 recall,zhangferry 的警告值得抄在这里:「知识还稀的时候,全员开启 recall 带来的往往是 token 账单,不是帮助」;第 2 个月起——看 digest 趋势做剪枝,第一个月当基线期,「不要急着宣布提效」(zhangferry)。推广用 champion 模式:先让 2-3 名核心成员试装、doctor 验证全绿,再铺开到全队(博客园 iTech)。

一句话收束:方向正确、工程扎实、闭环完整,但它只有四个月大、还没被生产环境验证过——把它当一个值得小范围试点的方向,而不是全公司铺开的标准答案。

参考阅读