TeamCity CLI（命令名 teamcity）是面向 TeamCity CI/CD 的命令行工具，让用户无需离开终端即可查询和控制构建、作业、项目、队列与代理等资源。
用途 该技能在以下情况使用：处理 TeamCity CI/CD 相关任务，或用户提供了 TeamCity 构建 URL。工具通过 teamcity 命令操作构建、日志、作业、队列和代理。
主要能力
- 构建（Builds）：run list、view、start、watch、log、cancel、restart、tests、changes。
- 制品（Artifacts）：run artifacts、run download。
- 元数据（Metadata）：run pin/unpin、run tag/untag、run comment。
- 作业（Jobs）：job list、view、tree、pause/resume、param list/get/set/delete。
- 项目（Projects）：project list、view、tree、param、token put/get、settings export/status/validate。
- 队列（Queue）：queue list、approve、remove、top。
- 代理（Agents）：agent list、view、enable/disable、authorize/deauthorize、exec、term、reboot、move。
- 池（Pools）：pool list、view、link/unlink。
- API：teamcity api <endpoint>，提供原始 REST API 访问。
使用方式 快速开始示例：
- teamcity auth status：检查认证状态。
- teamcity run list --status failure：查找失败的构建。
- teamcity run log <id> --failed：获取完整的失败诊断信息。
注意：不要猜测标志或语法，应使用命令参考或 teamcity <command> --help；必要时回退到 teamcity api /app/rest/...。术语上，构建对应 run（teamcity run），构建配置对应 job（teamcity job）。
常见工作流
- 排查失败：teamcity run list --status failure → teamcity run log <id> --failed → teamcity run tests <id> --failed。
- 从 URL 操作：从 https://host/buildConfiguration/ConfigId/12345 提取构建 ID 12345 → teamcity run view 12345。
- 启动构建：teamcity run start <job-id> --branch <branch> --watch。
- 查找作业：teamcity project list → teamcity job list --project <id>。
- 校验 Kotlin DSL：teamcity project settings validate（而非 mvn compile，详见 Workflows）。
适用场景 适用于在终端中检查构建状态、诊断失败、查看日志与测试结果、启动和监视构建、管理作业与项目参数、管理队列与代理、以及通过原始 REST API 扩展操作等 CI/CD 日常任务。
限制 资料未提供关于收费、价格、平台支持范围、性能效果或具体安装步骤的信息，暂未提供。使用时应以命令参考和 --help 为准，避免猜测标志或语法。