AI Agent 技能

TeamCity CLI 内置了一个技能，可教 AI 编码代理如何使用 teamCity 命令完成常见 TeamCity 工作流。该技能遵循 Agent Skills 规范，因此可与任何兼容的代理（如 Claude Code、Cursor 等）配合使用。

安装技能

为所有已检测到的 AI Agent 安装技能：

teamcity skill install

命令会自动检测系统中已安装的 AI 编码代理，并为每一个配置技能。如果未自动检测到代理，请传递 --agent 以明确目标。

指定一个或多个特定代理为目标：

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`	目标代理。可以重复。如果省略，则自动检测已安装的代理。
`--项目`	安装到当前项目，而非全局

向 AI Agent 开放 TeamCity 访问时，可能希望防止其触发构建、取消运行或修改配置。设置 TEAMCITY_RO=1 可将 CLI 限制为只读操作：

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

在只读模式下，代理可以列出构建、视图日志、检查失败并查询 API，但会阻止所有修改数据的命令。你也可以在配置文件中为每台服务器设置 ro: true。

CLI 可直接在沙盒 Agent 环境（如 Claude Code /sandbox ）中开箱即用。 CLI 会从 PEM 包文件加载 TLS 根证书，并遵循 HTTP 代理设置，这使其在平台证书库和直接网络访问受限时也能正常运行。

如果沙盒阻止了对 TeamCity 服务器的外部请求，请将服务器域名加入沙盒网络允许列表。

如果使用 Claude Code，也可通过插件系统直接安装 TeamCity 技能：

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

2026年 8月 6日