AI エージェントスキル

TeamCity CLI には、AI コーディングエージェントに一般的な TeamCity ワークフローで teamcity コマンドを使用する方法を教える組み込みスキルが含まれています。このスキルはエージェントスキル仕様(英語)に準拠しているため、互換性のあるエージェント（Claude Code、Cursor など）で動作します。

スキルのインストール

検出されたすべての AI エージェントにスキルをインストールします。

teamcity skill install

このコマンドは、システムにインストールされている AI コーディングエージェントを自動検出し、それぞれにスキルを設定します。エージェントが自動検出されない場合は、 --agent を指定して明示的にターゲットに設定してください。

特定のエージェントにインストールする

1 つ以上の特定のエージェントをターゲットにします。

teamcity skill install --agent claude-code
teamcity skill install --agent claude-code --agent cursor

プロジェクトレベルのインストール

スキルをグローバルではなく、現在のプロジェクトのみにインストールします。

teamcity skill install --project

スキルの更新

スキルを、現在の teamcity リリースにバンドルされている最新バージョンに更新します。

teamcity skill update

インストールされているバージョンがバンドルされているバージョンとすでに一致している場合、コマンドは更新をスキップします。

特定のエージェントをターゲットにするか、プロジェクトレベルでインストールします。

teamcity skill update --agent claude-code
teamcity skill update --project

スキルの除去

AI コーディングエージェントからスキルを削除します。

teamcity skill remove

特定のエージェントをターゲットにするか、プロジェクトレベルから削除します。

teamcity skill remove --agent claude-code
teamcity skill remove --project

スキルフラグ

これらのフラグは skill install、 skill update、 skill remove 全体で共有されます:

フラグ	説明
`-a`, `--agent`	対象エージェント。繰り返し可能です。省略した場合は、インストールされているエージェントを自動検出します。
`--project`	グローバルではなく現在のプロジェクトにインストールする

AI エージェントの読み取り専用モード

AI エージェントに TeamCity へのアクセスを許可する際、ビルドのトリガー、実行のキャンセル、構成の変更を防ぎたい場合があります。 CLI を読み取り専用操作に制限するには、 TEAMCITY_RO=1 を設定します。

export TEAMCITY_RO=1
teamcity skill install --agent claude-code

読み取り専用モードでは、エージェントはビルドの一覧表示、ログの表示、障害のインスペクション、API クエリを実行できますが、データを変更するコマンドはすべてブロックされます。設定ファイルでサーバーごとに ro: true を設定することもできます。

サンドボックスの互換性

CLI は、サンドボックス化されたエージェント環境（例: Claude Code、 /sandbox ）内で、すぐに動作します。 CLI は PEM バンドルファイルから TLS ルート証明書を読み込み、HTTP プロキシ設定を考慮するため、プラットフォーム証明書ストアや直接ネットワークアクセスが制限されている場合でも機能します。

サンドボックスが TeamCity サーバーへの送信リクエストをブロックする場合は、サーバードメインをサンドボックスのネットワーク許可リストに追加してください。

Claude Code 向けの代替インストール

Claude Code を使用する場合は、プラグインシステムを通じて TeamCity スキルを直接インストールすることもできます：

/plugin marketplace add JetBrains/teamcity-cli
/plugin install teamcity-cli@teamcity-cli

2026 年 9 月 11 日