Tencent/teamai-cli

什么是 TeamAI‑CLI？

TeamAI‑CLI 是一个命令行工具（发布在 npm 上），让软件团队将其 AI 相关资产——提示词、自定义代理、规则、环境配置、模型引用，甚至使用日志——视为存储在共享 Git 仓库中的一等代码。一旦有团队成员运行 teamai init <repo-url>，该工具会自动将最新的“团队 AI”文件同步到每个成员的本地工作区，因此每次 AI 会话（例如在 Claude、Codex、Cursor 等中）都使用相同的技能、策略和模型。

为什么重要

一致性 – 所有团队成员无需手动复制即可获得相同的提示库、安全规则和模型版本。
版本控制的 AI 资产 – 技能、钩子甚至模型引用都存放在 Git 中，因此您可以像审查代码一样审查、分支和回滚 AI 更改。
零接触更新 – 初始设置后，CLI 会在每次 AI 交互时拉取新资产，保持所有人同步。
兼容多种 AI 代理 – README 列出了数十种受支持的代理（Claude、Codex、Cursor、GitHub Copilot CLI 等），每种都会自动接收团队配置。

快速开始（适用于 AI 助手的一行命令）

安装 teamai 技能：https://github.com/Tencent/teamai-cli/tree/main/skills/teamai ，加载 teamai 技能，然后从头开始为我的团队设置 TeamAI。

助手运行上述命令后，您可以通过简单的聊天命令管理团队，例如：

/teamai 帮我从头开始为我的团队设置 TeamAI
/teamai 帮我加入我团队的 TeamAI，仓库 URL 是 https://github.com/your-org/your-repo
/teamai 与团队分享我的 xxx 技能
/teamai 打开 TeamAI 仪表盘

安装

# 通过 npm 全局安装
npm install -g teamai-cli

核心工作流程

创建共享 Git 仓库（GitHub、GitLab、GitCode、CNB、TGit 或任何私有 Git 服务）。保护默认分支并授予团队成员推送权限。
初始化 – 在工作区目录（默认）中运行 teamai init <repo-url>，或使用 --scope user 安装到 ~/ 下。
团队管理员可以从 teamai-hub 组织中的现成模板开始并分叉它。
团队成员只需运行相同的 teamai init 命令；CLI 会克隆仓库并设置本地钩子。
每次 AI 会话现在都会自动拉取最新的技能、规则、环境定义、模型引用和其他资产。

主要功能（基于 Git 分层）

层	作用
团队执行	将技能、规则、环境变量、代理、钩子、MCP 服务器和模型引用分发到每个队友的 AI 工具。
团队上下文（测试版）	为代理提供共享的学习成果、代码库图和团队维基，以便模型能够使用团队特定知识进行回答。
团队改进（测试版）	收集使用指标和会话日志，帮助团队了解 AI 的使用情况以及改进方向。

受支持的代理（节选）

代理	技能	规则	环境	代理	钩子	MCP	模型
Claude Code	✅	✅	✅	✅	✅	✅	✅
Codex	✅	✅¹	✅	✅	✅	✅	✅
Cursor	✅	✅	✅	✅	✅	✅	—
GitHub Copilot CLI	✅	✅	✅	✅	✅	✅	—
…（更多）

*¹ 规则无论文件路径如何都保持启用。 *² 环境变量仅通过 teamai env exec 应用。

文档与学习资源

入门指南 – docs/guide/getting-started.md
使用指南 – 日常工作流程和命令参考（docs/usage-guide.md）
产品概述 – 架构和分发控制（docs/product-overview.md）
Git 提供商 – 受支持的托管服务（docs/guide/providers.md）
Windows 设置 – 钩子和 shell 的特殊说明（docs/guide/windows.md）
技术设计 – 更深入的设计文档（docs/designs/README.md）

谁在维护？

该项目在 MIT 许可下开源，由腾讯编写。欢迎通过常规 GitHub 工作流程（问题、PR 和 CONTRIBUTING.md 指南）贡献。贡献者徽章显示社区活跃度。

总结

TeamAI‑CLI 将 Git 仓库转变为团队使用的所有 AI 资产的单一事实来源。全局安装，指向共享仓库，每个队友的 AI 工具就会自动与团队的提示词、策略、模型和使用分析保持同步。