腾讯这个 TeamAI CLI，想把团队的 Agent 配置放进 Git

GitHub 的 Today 榜上，腾讯旗下的 teamai-cli 在 2026 年 9 月 9 日观察时拿到 +563 stars，累计 2,898 stars。这个数字本身不够说明什么，但同一天它连续发出 v0.24.0-beta.1、.2、.3 三个预发布版本，改动集中在一个挺具体的问题：当团队同时使用 Codex、Claude Code、Cursor、OpenCode 和国内的代码 Agent 时，Skills、规则、MCP、知识到底怎样才能不靠人工复制来保持一致。

我会用这次更新拆一下 TeamAI CLI 的做法，也说清楚为什么它现在会出现在趋势页，以及哪些团队不该急着把它装进生产环境。期望对大家有所帮助。

配置不是一个文件，而是一条协作路径

teamai-cli 的入口并不复杂：管理员先准备一个共享 Git 仓库，团队成员执行 teamai init <repo>。此后，项目把 Skills、Rules、Agents、hooks、MCP、环境变量和文档放在同一个团队仓库里，而不是散落在每个人的本地目录。

它的关键不是“同步”两个字，而是把同步接在评审之后：

teamai push → 创建分支与合并请求 → 评审合并 → teamai pull
                                                    ↓
                                      SessionStart hook 注入本地 Agent

这条流程来自项目的 README。它解决的是很常见的团队摩擦：一个人更新了 AGENTS.md、一个人增加 MCP、另一个人在 Cursor 里保留了一份旧规则。工具本身不能消除差异，但把变更变成可评审的 Git 内容，至少让来源、版本和回退路径清楚了。

项目目前列出的兼容对象包括 Claude Code、Codex、Cursor、OpenCode、CodeBuddy、WorkBuddy、OpenClaw、Hermes、DeepSeek Harness、Qoder 和 ZCode。不同 Agent 的支持范围并不完全相同，README 也把 Skills、Rules、MCP、hooks、团队知识和看板等能力逐项列开；这比把“全兼容”写成一句口号更有用。兼容表 是实际部署前该看的第一处。

这轮 beta 真正在补什么

GitHub 的 v0.24.0-beta.3 发布说明 很长，但可以归成三件事。

第一是多项目与数据隔离。更新把新项目安装路径调整为 ~/.teamai/projects/<slug>/，并加入迁移旧 .teamai 数据的逻辑。共享规则在多个代码库之间有用，但会话经验、资源缓存和本地状态混在一起时，最容易把 A 项目的上下文带进 B 项目。这个改动不等于已经解决所有隔离问题，不过它至少把隔离变成产品明确维护的边界。

第二是团队分发的内容变多了。新版新增声明式团队环境安装，并继续管理 Skills、Rules、Agents、hooks、MCP 和 env。README 特别提醒：共享环境变量不应该放密钥。这一点很重要，因为“把团队配置 Git 化”如果没有权限和密钥边界，反而会把风险扩大到每台开发机。

第三是 Agent 接入还在扩展。该轮发布增加 JoyCode、Qoder 和 ZCode 的一等支持，也修了 Codex 对共享 Skills 的复用和 Stop 提示时机。换句话说，TeamAI 想做的不是另一套 Agent，而是不同 Agent 之上的团队配置层。

知识库的触发条件比“自动总结”克制一些

项目的 Team Context 仍标为 beta。它有一个值得注意的设计：不是每个会话都写成团队知识，而是由 Stop hook 根据“摩擦信号”决定是否提示贡献，例如用户打断 Agent、拒绝工具调用，或某个工具反复失败。

触发后，/teamai-share-learnings 可以把经验摘要写入团队仓库；另一侧的 teamai recall 需要显式开启，运行时会先做相关性预检，再让子 Agent 检索知识。项目还提供基于 tree-sitter WASM 的代码图谱抽取，以及失败时的启发式降级路径。这些细节都能在 中文 README 里核对。

这比把全部对话记录上传或全量索引更接近团队真正需要的东西：把“纠正过一次、踩过一次”的问题留下来。但它仍然会触及会话摘要、代码结构和团队 Git 权限，所以并不是打开一个开关就能放心使用。

为什么今天会被看到

趋势信号和版本信号在同一天叠在了一起。GitHub Trending Today 在观察时给出 +563，而仓库当天的三个 beta 不是只改文档：发布说明列出了多项目管理、数据目录调整、声明式环境安装，以及三个新 Agent 的接入。仓库本身创建于 2026 年 4 月 27 日，当前仍在快速迭代。GitHub API 的仓库元数据 可以核对创建时间、当前 star 和最近推送时间。

不过，不能从这个快照推出“它一天涨了多少总星”之外的结论，更不能把 2,898 的累计 star 写成当日增长。本文中的 +563 只指 GitHub 当日趋势页面在观察时显示的窗口值。

先在隔离仓库跑一遍

它更适合已经有明确规则、愿意让团队配置接受 Git 评审的小团队。如果团队只是两三个人各自试用一个 Agent，先共享一份轻量的 AGENTS.md 往往更简单。

准备试用时，我会先检查这几件事：

• 用临时仓库跑 teamai init，确认它会把哪些文件、hooks 和 MCP 配置写进 Codex 或其他 Agent 的目录
• 不把 API key、访问令牌或私人环境变量放进团队 env/，并单独检查 Git 仓库的写权限
• 逐项核对目标 Agent 的兼容表，尤其是 hooks、MCP、团队知识和 usage 数据是否真的受支持
• beta 版本先在非生产项目验证升级、卸载与多项目迁移，再让全员拉取

TeamAI CLI 的传播点不在于它又多了多少个 Skills，而在于它把团队使用 AI 的差异当成一个版本管理问题。这个判断是否成立，要看它能否在更多 Agent 之间稳定地处理权限、升级和本地状态，而不是只看今天的趋势数字。

---

• 仓库：github.com/Tencent/teamai-cli
• 最新预发布：v0.24.0-beta.3