Tencent/teamai-cli

TeamAI‑CLI とは？

TeamAI‑CLI は、ソフトウェアチームが AI 関連のアセット（プロンプト、カスタムエージェント、ルール、環境設定、モデル参照、さらには使用ログ）を、共有 Git リポジトリに保存された第一級のコードとして扱えるようにするコマンドラインツール（npm で公開）です。チームメンバーの一人が teamai init <repo-url> を実行すると、ツールは最新の「チーム AI」ファイルを各メンバーのローカルワークスペースに自動的に同期し、すべての AI セッション（例：Claude、Codex、Cursor など）が同じスキル、ポリシー、モデルで動作します。

重要な理由

一貫性 – すべてのチームメンバーが、手動コピーなしで同じプロンプトライブラリ、安全ルール、モデルバージョンを取得します。
バージョン管理された AI アセット – スキル、フック、モデル参照も Git に保存されるため、コードと同じように AI の変更をレビュー、ブランチ、ロールバックできます。
ゼロタッチ更新 – 初期設定後、CLI は AI 操作のたびに新しいアセットを取得し、全員を同期状態に保ちます。
多くの AI エージェントに対応 – README には数十の対応エージェント（Claude、Codex、Cursor、GitHub Copilot CLI など）がリストされ、それぞれがチーム設定を自動的に受け取ります。

クイックスタート（AI アシスタント向けのワンライナー）

tteamai スキルをインストール: 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 セットアップ – フックとシェルの特別な注意事項（docs/guide/windows.md）
技術設計 – より深い設計ドキュメント（docs/designs/README.md）

誰がメンテナンスしていますか？

このプロジェクトは MIT ライセンスの下でオープンソースであり、Tencent によって作成されています。通常の GitHub ワークフロー（issue、PR、CONTRIBUTING.md ガイド）を通じて貢献を歓迎します。コントリビューターバッジはコミュニティの活動を示しています。

要約

TeamAI‑CLI は Git リポジトリを、チームが使用するすべての AI アセットの単一の真実の源に変えます。グローバルにインストールし、共有リポジトリを指定すると、各メンバーの AI ツールはチームのプロンプト、ポリシー、モデル、使用分析と自動的に同期されます。