腾讯开源 teamai-cli，Git 驱动团队 AI 协作

teamai-cli是腾讯开源的一款Git驱动的团队AI协作基础设施。

简单说，它把团队里所有AI编程工具（Claude Code、Codex、Cursor、CodeBuddy、WorkBuddy、Gemini CLI、Windsurf、Trae、Aider……20多款）的Skill、Rule、Doc、Hook、MCP Server配置等资源，统一放进一个Git仓库里，用最原生的方式分发到每个人的本地AI中。

如果说以前每个开发者的AI配置是"各自为政的方言"，那 teamai-cli 就是给整个团队定义了一套"普通话"——大家用的AI工具可以不一样，但遵循的规范、拥有的技能、参考的文档，完全一致。

它相当于把公司的员工手册+培训体系+知识库管理系统，直接塞进了每个开发者的AI编程工具里。

而且是Git原生的，push、review、merge、pull，这套流程开发者用了十几年，零学习成本。

四大核心亮点

跨工具统一：20+ AI编程工具一套配置全同步

支持的工具列表长到吓人：Claude Code、Codex、Cursor、CodeBuddy IDE、WorkBuddy、Gemini CLI、Windsurf、Trae、Aider、Amp、OpenClaw……

只要是市面上主流的AI编程工具，teamai-cli 基本都覆盖了。

以前你在Claude里配好一套Skill，换Cursor就得重来一遍，换Codex又得重来。

现在不用了——把Skill放进TeamAI的共享仓库，一次配置，所有工具自动同步。

Claude的~/.claude/skills/、Cursor的~/.cursor/skills/、Codex的对应目录……teamai pull一跑，全部到位。

Git原生分发：开发者零学习成本，流程复用现有体系

TeamAI没有发明什么新奇的协作协议，也不搞什么中心化服务器。它的分发机制简单粗暴但极其有效：

teamai push → 自动创建分支 + 发起MR → 审核人审批 + 合并SessionStart Hook → teamai pull → 同步到本地所有AI工具

对，就是你天天用的Git工作流。

管理员在GitHub或TGit上建一个仓库，成员teamai init <仓库地址>一键接入。

想改规则？teamai push提交MR，审完合并，全队下一次开AI会话时自动生效。

没有学习曲线，没有洗脑培训，甚至不用通知大家——AI开个新会话，SessionStart Hook自动执行teamai pull，悄咪咪就同步好了。

四层能力矩阵：不止是同步配置，更是团队知识基础设施

teamai-cli本质上不只是个同步工具，它围绕AI的Harness层，构建了一整套四层能力体系：

第一层：Harness管理与分发——Skills、Rules、Docs、Hooks、Env、MCP配置，全量Git管理，一键分发。

第二层：跨团队技能订阅——通过teamai source add，可以订阅其他团队公开的技能仓库。安全团队出一套代码审计Skill，前端团队写一套组件规范Skill，各取所需，订阅即同步，形成团队间的"经验联邦"。

第三层：经验驱动的知识库——这是最有意思的一层。TeamAI内置了一套"摩擦信号"机制，每次会话结束时，Stop Hook会自动打分：你有没有打断过AI？有没有拒绝过它的工具调用？AI有没有反复重试失败的命令？

又长又顺的会话不会触发，但只要你"和AI搏斗过"，系统就会识别出这次会话里藏着值得记录的问题，主动提醒你：

[teamai] 本次会话可能包含值得记录的问题：你打断了AI 2次，AI重试失败的工具 8 次。任务：修复重复的项目级Hook注入问题建议运行 /teamai-share-learnings 总结本次经验并分享给团队。

个人踩坑的血泪史，就这样自动变成了团队的公共财产。

第四层：知识召回与复用——沉淀了经验还不够，能在对的时间想起来才是关键。TeamAI提供了基于BM25+图谱增强排序的召回子智能体，任务开始前自动检索团队知识库，还会先做一次相关性预检，与团队知识无关的任务直接跳过，不瞎打扰。

更狠的是teamai import，它能把代码仓库解析成结构化的知识图谱——组件、接口、配置、跨仓库依赖关系全部抽取出来。AI检索时直接带着"地图"去改代码，不用再像盲人摸象一样从头探索整个仓库。

角色与权限：devops和PM用不同的Skill包，互不干扰

不是所有人都需要同样的技能。后端开发需要部署和数据库调优的Skill，前端需要组件和构建的Skill，PM可能只需要项目文档和需求管理的Skill。

TeamAI通过manifest/roles.yaml实现了基于角色的技能隔离。

管理员定义好角色（hai、pm、devops……），每个角色绑定不同的命名空间，成员teamai roles set hai选好自己的角色后，pull只会同步对应命名空间下的技能，干净利落。

甚至还支持主角色+附加角色的组合：teamai roles set hai --add pm，主用后端技能，顺便也能看到PM的规范文档。

快速上手

第一步：安装

# 需要 Node.js ≥ 18npm install -g teamai-cli# 验证安装teamai --version

第二步：管理员初始化（只需做一次）

在GitHub/TGit/CNB上建一个空仓库，建议命名为TeamAi-<团队名>，给成员开写权限。然后：

# 项目级（默认，资源装在项目目录下）cd /path/to/my-projectteamai init <你的组织>/TeamAi-<团队名># 或者用户级（资源装在~/下，跨项目通用）teamai init <你的组织>/TeamAi-<团队名> --scope user

个人开发者甚至不用先建仓——teamai init检测到仓库不存在时，会自动帮你创建。

第三步：团队成员接入

npm install -g teamai-cli# 成员在自己的项目目录里执行cd /path/to/my-projectteamai init https://github.com/你的组织/TeamAi-你的团队

完了。从此每次打开AI会话，自动同步最新资源。

第四步：日常使用

分享资源到团队：

# 本地写好Skill/Rule/Doc后teamai push          # 检测变更，创建MR等待审核teamai push --all    # 跳过确认，直接推送

手动同步（一般不需要，自动的）：

teamai pull              # 拉取最新teamai pull --dry-run    # 预览一下，不实际改

查看状态：

teamai status     # 当前作用域、最后同步时间、资源数量teamai list       # 所有Skills/Rules/Docs/Env/Agents/Hooks/MCPteamai members    # 看队友们都有谁teamai skill show <技能名>  # 看某个技能的详情

不想用某个团队共享的Skill？本地排除，不影响别人：

teamai skill exclude add using-superpowersteamai pull   # 本地就不装这个了# 想用回来teamai skill exclude remove using-superpowersteamai pull

跨团队订阅别人的技能：

teamai source add https://github.com/other-team/teamai-public.git --name other-teamteamai source browse other-team   # 看看他们有啥好东西

把代码库导入成知识图谱：

teamai import --from-repo https://github.com/org/repoteamai recall "GPU内存溢出"  # 搜搜团队有没有人踩过这个坑

一键开启知识召回：

teamai recall enable    # AI做事前会先搜一下团队知识库

看团队AI使用数据面板：

teamai dashboard --port 8080

最近两年 AI 编程工具的迭代快到令人眼花缭乱，模型换了一茬又一茬，工具出了一个又一个。

但很少有人关注一个最朴素的问题：我们给AI花了那么多时间调教的那套东西，能不能带走？能不能复用？能不能共享？

teamai-cli 给出的答案非常务实：就用你们已经用了十几年的Git，把技能、规则、经验全部装进去，按已经跑通的协作流程流转。

没有颠覆式创新，但每一步都踩在开发者最熟悉的节奏上。

这大概就是腾讯做基础设施的风格吧——不搞花里胡哨的概念，扎扎实实把团队协作里最痛的那些"小事"给解决了。

GitHub：https://github.com/Tencent/teamai-cli