TeamAI：用 Git 同步团队 AI 技能与规则
TeamAI 给多 Agent 团队统一分发 skills、规则和 MCP，区别是用 Git review 流程管理 AI Harness。
GitHub Tencent/teamai-cli 更新 2026-09-10 分支 main 星标 3.0K 分叉 185
TypeScript Python JavaScript AI Agent 协作 Claude Code MCP GitHub/GitLab npm CLI

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你们同时使用 Claude Code、Codex 或 Cursor，并希望共享 skills 与 rules。
    README 的 Overview 列出这些 Agent，Team Execution 说明共享 skills、rules、docs 和 hooks。
  • 团队已有 GitHub、GitLab 或私有 Git 服务，并能授予成员写权限。
    README 的 Quick Start 要求创建 shared-experience repo 并 grant write access to team members。
  • 你们希望用 teamai roles、tags 控制不同成员的技能同步范围。
    README 的 Distribution Controls 介绍了 Roles、Tags 和 Sources。
  • 你们希望把高 friction 会话沉淀为团队知识，并使用 teamai recall 搜索。
    README 的 Team Context 说明 Stop hook 按 friction 触发分享，Commands 列出 teamai recall。

不适合，如果你

  • 你的 AI 工具提供商需要 Models 配置，但项目尚未为每个 provider 实现 Models。
    README 的 What Gets Shared 表中写明 Models — Not implemented for every provider yet。
  • 你不能提供 Git 仓库写权限，或团队不接受 push、review、merge、pull 流程。
    README 的 Quick Start 要求成员拥有写权限，How It Works 展示 teamai push → review & merge → teamai pull。
  • 你需要把 secrets 放进团队共享环境配置 env/。
    README 的 What Gets Shared 明确写着 env/ 中 do not put secrets here。
  • 你只需要单机配置，不需要团队 Harness、teamai pull 或知识库功能。
    README 将核心流程定义为共享 Git repo、teamai push 和 teamai pull，并将 recall 等列为团队能力。

前置条件

  • 需要安装 npm 包：teamai-cli。
  • 需要在 GitHub、GitLab、GitCode、CNB、TGit 或私有 Git 服务创建共享仓库。
  • 需要 grant write access to team members。
  • 支持 Claude Code、Codex、CodeBuddy、WorkBuddy、OpenCode、Cursor 等 AI Agent。

第一步命令（README 原文）

npm install -g teamai-cli

要注意

  • teamai init 会 inject hooks，卸载需使用 teamai uninstall。
    README 的 Commands 将 init 描述为 inject hooks，并列出 teamai uninstall。
  • teamai packages 当前只支持 npm packages 和 Claude Code plugins。
    README 的 Commands 对 teamai packages 的说明限定为 npm packages and Claude Code plugins only。
  • 自动经验分享每个 session 最多提示一次，且可能包含脱敏任务摘要。
    README 的 Automatic Experience Sharing 写明 each session is prompted at most once，并说明 summary 会被 redacted。
  • docs/ 采用 progressive disclosure，不是所有文档默认加载。
    README 的 What Gets Shared 对 Docs 的备注为 not all loaded by default (progressive disclosure)。

材料未说明

  • README 未说明 Node.js、npm 或 Python 的最低版本。
  • README 未说明 Claude Code、Codex、Cursor 等 Agent 的具体兼容版本。
  • README 未提供团队规模、仓库规模与 teamai pull 的性能数据。
  • README 未说明 Other 许可协议的具体许可证文本和使用限制。
  • README 未说明 v0.24.0-beta.3 相比前一版本的变更内容。

💡 深度解析

6
不适合 我需要把团队级环境变量、MCP 和 Hooks 分发给 Codex 与 Cursor，但安全政策禁止密钥进入 Git；TeamAI 的 env 机制是否可以直接承担密钥管理？
适合读者： 在企业 Git 仓库中管理 env、MCP 和团队规则，且安全要求禁止把密钥提交到共享仓库的研发安全工程师

不适合，TeamAI 能分发团队级 env，但 README 明确警告不要把 secrets 放入该目录，因此它不能替代密钥管理系统。

  • What Gets Shared 将 env/ 定义为共享团队级环境变量和开关，同时明确写着 do not put secrets here。
  • MCP、Hooks 和 env 都会通过团队仓库及 teamai pull 注入本地 AI 工具，错误提交可能随同步扩散到成员机器。
  • README 的分发模型依赖 Git 仓库权限；它没有描述密钥引用、运行时注入、轮换、审计或加密存储能力。
  • 所以 TeamAI 可以管理非敏感开关和 MCP 声明，但你的密钥必须由外部企业密钥系统提供；仅靠 TeamAI 不满足该安全约束。
  • README「What Gets Shared」：`Env | env/ | Shared team-level environment variables and switches; do not put secrets here`
  • README「Team Execution」：资源通过 `teamai pull` 分发到每个 agent
  • README「Quick Start」：需要 grant write access to team members
  • 项目洞察「usage_limitations」：不能替代完整的密钥管理和安全系统
材料未说明：README 未说明可集成哪些企业密钥管理系统，以及 MCP 凭据是否支持运行时引用。；README 未说明 env 文件的权限、加密、审计和轮换机制。
不适合 我们主要使用 OpenCode、OpenClaw、Hermes 和 DeepSeek Harness，但要求模型配置、上下文和团队规则与 Claude Code 保持一致；TeamAI 能否保证这些代理的行为等价？
适合读者： 需要在 OpenCode、OpenClaw、Hermes 或 DeepSeek Harness 上复用团队规则，并要求模型配置和上下文行为与 Claude Code 一致的 AI 工具负责人

不适合把 TeamAI 当作行为等价保证层，因为 README 明确显示不同代理的能力矩阵并不一致，Models 也尚未对每个 provider 实现。

  • Overview 表中，OpenCode、OpenClaw、Hermes 和 DeepSeek Harness 对部分资源列出 —，说明并非所有 Team Context 或 Improvement 能力都可用。
  • What Gets Shared 明确写着：Models — Not implemented for every provider yet。
  • TeamAI 的优势是分发 skills、rules、docs、agents、hooks 和 MCP，而不是把不同代理的模型调用、上下文窗口或执行语义统一起来。
  • 因此它可以作为资源同步层，但不能满足“与 Claude Code 行为一致”的硬约束；README 也没有提供跨代理回归或等价性验证机制。
  • README「Overview」：OpenCode、OpenClaw、Hermes、DeepSeek Harness 的能力矩阵包含 `—`
  • README「What Gets Shared」：`Models — Not implemented for every provider yet`
  • README「Team Execution」：共享资源包括 skills、rules、docs、agents、hooks、MCP
材料未说明：README 未说明各代理对同一 skill、MCP、Hook 和规则的具体解析差异。；README 未说明是否存在官方的跨代理兼容性测试、版本支持范围或行为一致性指标。
适合 我们同时使用 Claude Code、Codex 和 Cursor，团队资源要放在私有 Git 服务中，并且所有技能、规则、Hooks 和 MCP 变更都必须经过合并请求审核；TeamAI 是否适合做统一分发？
适合读者： 负责研发效能、需要在 GitHub、GitLab 或私有 Git 服务中统一 Claude Code、Codex、Cursor 配置的团队管理员

适合，因为它把 Git 仓库作为团队 Harness 的协作底座，并直接覆盖你列出的多代理和审核流程。

  • README 明确支持 Claude Code、Codex、Cursor，并可管理 skills、rules、agents、hooks、MCP、env 和 docs。
  • teamai push 会创建分支和 MR，审核合并后，SessionStart Hook 执行 teamai pull，成员无需手工同步。
  • Git 提供商包含 GitHub、GitLab、GitCode、CNB、TGit 和 private Git service；roles、tags、source 还能限制不同成员收到的资源。
  • 但 Models 尚未对每个 provider 实现，且 Team Context 与 Team Improvement 标注为 beta，因此不能把跨代理行为等同于完全一致。
  • README「Team Execution」：`teamai push → create branch + MR → reviewer approves + merges`
  • README「Team admin / solo user」：GitHub、GitLab、GitCode、CNB、TGit 或 private Git service
  • README「What Gets Shared」：Skills、Rules、Agents、Hooks、MCP、Env
  • README「Product architecture」：Team Context (beta) × Team Improvement (beta)
npm install -g teamai-cli
材料未说明：README 未说明私有 Git 服务所需的认证协议、OAuth 配置方式和企业代理网络兼容性。；README 未给出不同代理对同一 skill、Hook 或 MCP 配置的具体差异矩阵。
视情况 我已经有项目级 CLAUDE.md、AGENTS.md、Hooks 和 MCP 配置，还要同时给 Codex 与 Cursor 接入团队规则；我应该使用 project scope 还是 user scope，TeamAI 会不会覆盖现有配置？
适合读者： 维护已有项目级 CLAUDE.md、AGENTS.md、Hooks 和 MCP 配置，并在同一台机器上使用 Codex 与 Cursor 的应用开发者

视情况，TeamAI 同时支持 project scope 和 user scope，但 README 没有承诺与既有配置的合并、覆盖优先级或冲突解决规则。

  • 默认 project scope 会把资源安装到项目目录，适合项目专属规则；--scope user 则安装到 ~/，更适合跨项目共享内容。
  • init 会注册成员并注入 Hooks，随后 AI 会话自动拉取最新 skills、rules 和其他 Harness 更新。
  • README 明确把 CLAUDE.md、agents、hooks、MCP 列为可共享资源，因此现有本地文件可能与团队资源发生重名或行为冲突。
  • status 可显示本地与团队仓库差异，doctor 可诊断配置问题，但没有说明它们能否自动合并冲突。
  • README「Team members」：Project-scope init（default）与 `teamai init ... --scope user`
  • README「Quick Start」：每个 AI session 自动 pulls 最新 skills / rules 和 Harness updates
  • README「What Gets Shared」：CLAUDE.md、Agents、Hooks、MCP
  • README「Commands」：`teamai status` 与 `teamai doctor`
teamai init https://github.com/yourorg/yourrepo
材料未说明：README 未说明 project scope 与 user scope 的优先级、重复资源覆盖规则以及现有 CLAUDE.md/AGENTS.md 的合并行为。；README 未说明 SessionStart Hook 在网络不可用或本地已有同名 Hook 时的失败策略。
适合 我们还没有团队 Git 仓库，主要使用 Cursor 和 Claude Code，希望先获得预置的 skills、rules 和 review agents；TeamAI 的首次接入是否足够直接？
适合读者： 没有现成团队仓库、希望直接使用预置生产级 skills、rules 和 review agents 的个人开发者或小型团队

适合，README 为没有团队仓库的用户提供了模板入口，并把 Cursor 与 Claude Code 列为支持的代理，首次接入路径相对清晰。

  • Quick Start 建议从 teamai-hub 选择模板，模板已预加载 production-ready skills、rules 和 review agents。
  • 安装只需全局安装 CLI，再针对新建仓库运行 teamai init；项目级 scope 默认把资源放进当前项目。
  • 初始化后，每个 AI session 会自动拉取管理员发布的 Harness 更新，减少手工同步步骤。
  • 但完整能力仍需要理解 Git 仓库、Hooks、资源格式和 MR 流程；项目版本为 v0.24.0-beta.3，且总发布数只有 5 次，因此稳定性和长期兼容性需要另外确认。
  • README「Quick Start」：从 teamai-hub 模板开始，预加载 production-ready skills、rules 和 review agents
  • README「Team members」：project-scope init 为默认范围
  • README「Quick Start」：每个 AI session 自动 pulls 最新 Harness updates
  • 项目核心数据：latest_release 为 v0.24.0-beta.3；release_count 为 5
  • README「Overview」：Claude Code、Cursor 均列为支持代理
npm install -g teamai-cli
材料未说明：README 未说明 teamai-hub 模板的维护频率、模板之间的差异和与 v0.24.0-beta.3 的兼容范围。；README 未说明首次初始化是否必须配置 OAuth，以及个人用户在没有团队管理员时的权限模型。
视情况 我想用 Claude Code 的会话经验改进团队技能，但企业要求客户代码和未脱敏摘要只能留在内网；TeamAI 的 recall、session save 和 promote 是否能满足这个约束？
适合读者： 希望把 Claude Code 会话经验转成团队技能，但所在企业禁止未脱敏会话摘要和客户代码离开内网的 AI 平台工程师

视情况，因为 TeamAI 提供隐私清洗和知识生命周期命令，但 README 没有把它定义为企业级数据隔离或合规系统。

  • teamai session save 会记录 privacy-scrubbed session summary，并可用 --push 写入 digest；recall promote 可把高置信度 learning 转成 skill、rule 或 doc。
  • recall 使用 BM25 + graph-boost 搜索团队知识，codebase --extract 会抽取代码事实并在 teamwiki/ 构建本地图谱。
  • Team Context 和 Team Improvement 都是 beta，且项目洞察明确指出会话摘要和代码上下文仍有隐私风险。
  • 因此只有在确认脱敏边界、Git 仓库位置、保留期限和内网部署方式后才适合；README 没有给出这些控制项。
  • README「Commands」：`teamai session save` 会记录 privacy-scrubbed session summary
  • README「Commands」：`teamai recall` 使用 BM25 + graph-boost；`recall promote` 提升 learning
  • README「Commands」：`teamai codebase --extract [path]` 构建 `teamwiki/`
  • README「Product architecture」：Team Context (beta)、Team Improvement (beta)
teamai session save
材料未说明：README 未说明隐私清洗的规则、可配置字段、客户代码识别能力和是否支持组织级保留期限。；README 未说明知识库是否可以完全部署在企业内网，以及 recall 服务是否需要外部网络。

✨ 核心亮点

  • 支持 Claude Code、Codex、Cursor 等多种 Agent
  • 用 push、review、pull 分发团队 Harness
  • 提供 recall、codebase 图谱与经验共享
  • Team Context 与 Team Improvement 标为 beta

🔧 工程化

  • teamai init 将共享仓库资源注入本地 AI 工具
  • teamai roles 与 tags 控制技能同步范围
  • teamai recall 用 BM25 加图谱增强搜索知识
  • Stop hook 按 friction 提示分享会话经验

⚠️ 风险

  • Team Context 和 Team Improvement 仍处于 beta
  • env/ 明确禁止放置 secrets，需管理敏感配置
  • Models 对每个 provider 尚未实现完整支持
  • 初始化要求 Git 仓库并授予团队成员写权限

👥 适合谁？

  • 使用 Claude Code、Codex 或 Cursor 的开发团队
  • 需要 GitHub、GitLab 或私有 Git 服务共享规则的团队
  • 希望统一 skills、hooks、MCP 与 agents 配置的组织