Research brief · 2026 年 9 月 21 日

Tencent TeamAI CLI 调研

TeamAI 给 Claude Code、Codex、Cursor 等 AI 编程工具加一层团队协作：用 Git 仓库分发 skills、rules、hooks、MCP 和团队知识，再把会话里的经验送回仓库评审。

数据截至 2026-09-21稳定版 0.24.0来源：腾讯官方仓库与 npm

先说结论

TeamAI 适合已经让多人使用多种 AI 编程工具、又不想靠手工复制配置的团队。它把团队工作方式放进 Git，沿用分支、评审和合并；模型能力仍由 Claude Code、Codex、Cursor 等工具提供。Team Context 和 Team Improvement 在官方文档中仍标为 beta，先从 skills 与 rules 的分发开始更稳妥。¹

0.24.0npm 稳定版

0.25.0-beta.3最新预发布版

4,846GitHub stars

351GitHub forks

一、TeamAI 是什么

团队把 skills、rules、docs、agents、hooks、MCP、环境配置和包声明放在一个共享 Git 仓库。成员执行 teamai pull 后，这些资源会按各 AI 工具的原生目录和格式写到本机。成员用 teamai push 分享改动时，TeamAI 创建分支和 MR，由 reviewer 合并后再分发。¹²

它不提供新的模型推理，也不替代现有 AI 工具。可以把它理解为“AI 工作方式的团队配置仓库 + 分发器 + 经验库”。官方口号是 “Make Every Team AI Native”。

TeamAI 管理的主要资源
资源	仓库中的位置	用途
Skills	`skills/<name>/SKILL.md`	让 Agent 执行团队约定的任务流程
Rules	`rules/*.md`	编码、评审和协作规则
Docs	`docs/`	供 Agent 按需读取的项目资料
Agents	`agents/`	团队自定义子 Agent
Hooks / MCP	`hooks/hooks.yaml`、`mcp/mcp.yaml`	生命周期动作与外部工具连接
Packages	`teamai.yaml`	声明 npm 包和 Claude Code 插件

二、三层能力

2.1 Team Execution

这一层负责把团队的 AI 工作方式送到每位成员的工具里。除了 skills、rules、docs、agents、hooks、MCP 和 env，0.24.0 还加入了团队包声明。teamai packages 调用本机的 npm 与 Claude Code 插件命令，安装前可用 --dry-run 预览；普通 pull 只提示，不会自动执行第三方安装命令。²

2.2 Team Context

teamai recall 搜索 learnings、docs 和代码知识图谱。该功能默认关闭，团队可以在 teamai.yaml 打开，成员也能在本机覆盖。teamai import 与 teamai codebase 用 tree-sitter WASM 和启发式规则提取代码结构；TypeScript、JavaScript、Python、Go 有 AST 轨道，其他语言走启发式提取。¹²

2.3 Team Improvement

会话结束时，Stop hook 会根据打断、纠正、拒绝工具调用、工具重试等摩擦信号判断本次会话是否值得记录。达到门槛后，它提示成员运行 /teamai-share-learnings。teamai digest 生成近 7 天团队周报，teamai dashboard 展示本机会话、趋势、估算费用和知识库健康。官方仍把 Team Context 与 Team Improvement 标为 beta。¹

三、工作方式

01 · INIT关联团队仓库，选择 project 或 user scope，注入对应工具的资源与 hooks。
02 · PUSH成员把新 skill、rule 或 learning 推到单独分支并创建 MR。
03 · REVIEWReviewer 评审并合并，把团队工作方式当作代码管理。
04 · PULL新会话通过 SessionStart hook 拉取更新；不支持 hook 的工具手动 pull。

teamai push → branch + MR → review + merge
                                      ↓
SessionStart hook → teamai pull → local AI tools

Project、Role、Tag、Source 是四种分发维度。Project 回答当前目录属于哪个项目，Role 回答成员做什么工作，Tag 让成员订阅一组资源，Source 让团队订阅其他仓库的公开 skills。Project 与 Role 可以同时使用。¹²

四、安装与开始使用

4.1 官方推荐入口

README 现在把 skill 作为第一入口：把下面这句话交给支持安装 skill 的 AI 工具，让它加载 TeamAI 的内置 skill，再按对话完成团队初始化。¹

帮我装好 teamai skill：
https://github.com/Tencent/teamai-cli/tree/main/skills/teamai
加载 teamai skill，然后从零搭建团队的 TeamAI。

安装后，可以用 /teamai 让 AI 帮忙建团队、加入仓库、分享 skill 或打开团队看板。

4.2 命令行安装

手动安装需要 Node.js 20 或更高版本与 Git。公开 npm 包名是 teamai-cli。²³

npm install -g teamai-cli
teamai --version

# 项目级，默认
cd /path/to/my-project
teamai init https://github.com/yourorg/your-teamai-repo

# 检查与同步
teamai doctor
teamai status
teamai pull

包名 npm 上还有一个无关的 @teamai/cli，用途是同步 TeamAI sandbox 文件。腾讯这个项目的公开包名是 teamai-cli，仓库地址是 Tencent/teamai-cli。³

4.3 Project 与 User scope

两种安装范围
范围	资源位置	适用情况
Project（默认）	资源写到当前项目；机器数据放在 `~/.teamai/projects/<slug>/`	项目专用 rules、skills 和 MCP
User	资源写到用户目录；用 `--scope user` 初始化	跨项目共用的个人或公司级工作方式

两个 scope 可以共存，但 project scope 默认与 user scope 隔离。项目需要读取安全的 user 资源时，用 --inherit-user-scope；env、MCP、外部 sources、用量上报和远端写入不会继承。²

五、Agent 支持

官方功能矩阵在 2026 年 9 月 21 日列出 14 种 Agent。Claude Code、Codex、Cursor、CodeBuddy、Qoder 与 Kiro 覆盖表中的 13 项能力；其他工具按各自文件格式和生命周期接口提供部分能力。¹

按官方矩阵归纳的支持状态
状态	Agent	边界
完整	Claude Code、Codex、Cursor、CodeBuddy、Qoder、Kiro	矩阵中的 Execution、Context、Improvement 项均为 ✓
大部分	WorkBuddy、ZCode、Oh My Pi	缺少少数资源类型或团队用量能力
部分	GitHub Copilot CLI、OpenCode、OpenClaw、Hermes、DeepSeek Harness	主要差异在 hooks、agents、MCP 或 Improvement

自动同步取决于 Agent 是否开放生命周期 hook。JoyCode、Gemini CLI 等当前需要手动执行 teamai pull；Kiro 只有交互式 CLI 中激活 TeamAI 渲染的自定义 Agent 时才会触发对应 hook。²

六、适合什么团队

采用 TeamAI 前的判断
情况	判断	原因
多人使用多种 AI 编程工具	适合	同一套资源会被转换到不同工具的原生目录
团队已经用 Git 与 MR 评审	适合	可以沿用现有权限、分支与 review 流程
多个项目共用一个团队仓库	适合	0.24.0 已提供 Project 与 Role 两个分流维度
一个人只用一种工具	收益有限	直接管理工具自己的 rules 与 skills 更简单
期望安装后模型能力变强	不匹配	TeamAI 管理上下文和工作方式，不提供模型
不能接受本机配置与 hook 改动	不匹配	同步功能需要写入各工具的配置和资源目录

建议试法 先建一个小型团队仓库，只放 2 到 3 个已经反复使用的 skills 和 rules。选一个项目、两位成员、两种 Agent 跑一周；确认 pull、MR、卸载和密钥边界后，再打开 recall、session 上报与 dashboard。

七、安全与运维边界

团队 hooks 可以分发并执行命令。Review 需要像看 CI 脚本一样看 hooks/hooks.yaml；可用角色限制控制分发范围。²
MCP 配置中应用 ${VAR} 引用密钥。解析后的 token 会以明文写进各 Agent 的本地配置，项目级 MCP 文件必须加入 .gitignore。²
单仓模式下的 .teamai/env/env.yaml 会提交到 main，只能放非敏感配置。真实密钥留在未跟踪的本机环境。²
团队包声明不会随着 pull 自动执行。成员运行 teamai packages 才会安装，执行前可以用 --dry-run 看具体命令。²
用量上报可以在 teamai.yaml 设 usageReport: false 关闭。会话摘要、投票、成员与统计写进独立的 teamai-reports 分支。²
自动更新由团队的 autoUpdate 与本机的 updatePolicy 控制，本机设置优先。生产环境可以改为提示或跳过。²
teamai uninstall --dry-run 会预览删除范围；正式卸载只清理 TeamAI 管理的资源，并保留用户自己创建的内容。²

八、成熟度判断

截至 2026 年 9 月 21 日 10:55（新加坡时间），GitHub API 返回 4,846 stars、351 forks、35 个 open issues，仓库当天仍有提交。npm 的稳定版是 0.24.0，发布于 9 月 14 日；GitHub 最新预发布版是 0.25.0-beta.3，发布于 9 月 18 日。项目使用 TypeScript、ESM、tsup 与 Vitest，公开包采用 MIT License。³⁴⁵⁶

发布节奏很快，9 月 14 日到 18 日已经从稳定版进入三轮 beta。快速变化带来更多 Agent 和功能，也会让文档、main 分支版本号与已发布包短期不一致。团队应固定稳定版，升级前看 release notes，并在小范围验证 hooks、MCP 和数据迁移。

判断边界 这份调研核对了公开文档、发布记录、npm 元数据和关键配置说明，没有安装 14 种 Agent 做端到端测试，也没有审计全部源码。Agent 兼容性采用官方功能矩阵。

九、方法与来源

资料取样于 2026-09-21。版本以 npm latest 和 GitHub release 为准；仓库规模来自 GitHub API；功能与安全边界以中文 README、中文使用指南和 0.24.0 发布说明交叉核对。数字是当时快照，会继续变化。

Tencent，《TeamAI README 中文版》，访问于 2026-09-21，github.com/Tencent/teamai-cli/blob/main/README.zh-CN.md
Tencent，《TeamAI CLI 团队上手与使用指南》，访问于 2026-09-21，github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.zh-CN.md
npm，《teamai-cli》，稳定版 0.24.0，访问于 2026-09-21，npmjs.com/package/teamai-cli
Tencent，《teamai-cli v0.24.0 Release》，2026-09-14，github.com/Tencent/teamai-cli/releases/tag/v0.24.0
Tencent，《teamai-cli Releases》，访问于 2026-09-21，github.com/Tencent/teamai-cli/releases
GitHub REST API，《Tencent/teamai-cli repository metadata》，取样于 2026-09-21 10:55（Asia/Singapore），api.github.com/repos/Tencent/teamai-cli