TeamAI CLI — 团队 Agent 技能管理工具

产品简介

TeamAI 是腾讯开源的团队级 AI 编码智能体配置管理工具，通过一个 CLI 将团队的 Skills、Rules、MCP 配置、知识库和协作规范统一管理、分发到每位成员的编码 Agent 中。目前支持 Claude Code、Codex、Cursor、CodeBuddy、WorkBuddy、OpenCode、OpenClaw、Hermes、DeepSeek Harness、Qoder、ZCode 等十余款主流编码 Agent，覆盖从个人到企业全场景的团队协作需求。项目在 GitHub 累计获得约 2.8k 星，NPM 包全球周下载量持续增长，是当前团队级 Agent 配置管理领域最完整的开源方案之一。

核心能力

• 多 Agent 统一管理：支持 11 款主流编码 Agent，管理员在团队仓库中配置一次，所有成员的 Agent 启动时自动同步，无需逐台手动更新
• Harness 分发体系：将 Skills、Rules、Docs、Agents、Culture、CLAUDE.md、Env、Hooks、MCP、Packages 共 10 类资源统一存放于共享 Git 仓库，通过「push → review & merge → pull」的标准流程分发更新
• 角色与标签订阅机制：支持基于角色的权限控制，管理员定义「角色 → 命名空间」映射，不同职能成员只同步与自己相关的 Skills 子集
• 跨源订阅能力：可订阅其他团队的公开 Harness 仓库，实现跨团队技能共享
• 团队知识库（Team Context）：自动将团队积累的项目经验、代码结构组织成可检索知识库，Agent 在会话中自动召回相关信息
• 自我改进机制（Team Improvement）：Stop Hook 根据摩擦信号评估会话是否值得记录，高分会话自动建议沉淀为团队知识

安装配置

TeamAI 采用 npm 全局安装，Node.js ≥ 18 即可运行：

# 全局安装 CLI
npm install -g teamai-cli

# 初始化团队仓库（需先在 Git 托管平台创建共享仓库）
cd /path/to/my-project
teamai init https://github.com/yourorg/yourrepo

还没有团队仓库时，可从 teamai-hub 模板库中选择角色模板（目前有 template-backend 后端工程师模板），快速生成预置了 Skills、Rules 和 Review Agents 的团队仓库。

使用步骤

1. 访问 github.com/teamai-hub，选择角色模板并点击「Use this template」生成自己的团队仓库
2. 授予团队成员该仓库的写权限
3. 各成员在项目目录下执行 teamai init https://github.com/yourorg/yourrepo 完成初始化
4. 管理员在仓库中新增或更新 Skills / Rules 等资源后，执行 teamai push 创建分支并发起 Merge Request
5. 评审者审批合并 MR 后，团队成员下次启动 Agent 时，SessionStart Hook 自动触发 teamai pull，最新配置同步到本地

适用场景

• 技术团队规模化引入 AI 编码工具：统一管理 Claude Code / Cursor 等编码 Agent 的配置，解决「每人配置不一、规则难以统一」的问题
• 跨角色 Agent 规范管理：前端、后端、QA 等角色通过角色订阅机制各取所需，避免信息过载
• 企业级 AI 编码规范落地：通过 Rules、Culture、CLAUDE.md 等机制，将代码规范、协作准则注入每次 AI 会话
• 跨团队技能共享：各团队将成熟的 Skills 发布为公开仓库，其他团队通过订阅机制复用

适用人群

• 工程团队负责人 / CTO：统一管理团队 AI 工具配置
• AI 工具推广负责人：帮助团队规模化引入编码 Agent
• DevOps / 平台工程师：构建企业内部 AI 编码平台的基础设施层
• 独立开发者：利用 teamai-hub 模板快速搭建个人开发规范体系

工作原理

TeamAI 的核心是一个「共享 Git 仓库 + Hook 自动化」的分发架构。团队共享仓库按固定目录结构存放各类 Harness 资源（skills/、rules/、mcp/ 等），teamai-cli 提供 init / pull / push / roles 等命令封装 Git 操作和 Agent 配置写入逻辑。在编码 Agent 的启动/结束阶段注册 Hook（SessionStart / Stop），自动触发 pull / 评分 / 知识沉淀等操作。通过检测各 Agent 的配置文件路径（Claude Code 的 .claude/、Cursor 的 .cursor/ 等）实现统一的写入适配层，天然支持多 Agent 并存。

官方链接

• GitHub 仓库：https://github.com/Tencent/teamai-cli
• NPM 包：https://www.npmjs.com/package/teamai-cli
• 团队模板库：https://github.com/teamai-hub
• 官方文档（英文）：https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.md
• 官方文档（中文）：https://github.com/Tencent/teamai-cli/blob/main/docs/usage-guide.zh-CN.md