Trợ lý TeamCity CLI
Giúp Claude điều khiển CLI `teamcity` để tra lỗi build, xem log, quản lý queue, agent và pipeline của TeamCity.
Lập trìnhTrung cấp★ 121⑂ 16Điểm AI 8/10Cập nhật lần cuối: 20 thg 8, 2026
Làm được gì
- Cung cấp bản đồ lệnh đầy đủ của CLI
teamcitychính thức: build (run), cấu hình build (job), project, VCS root/connection, queue, agent, agent pool, pipeline và cả REST API thô. - Chuẩn hoá quy trình điều tra lỗi: liệt kê build thất bại → dump log lỗi ở dạng thô → xem test fail → dùng
run treeđể tìm dependency lỗi sâu nhất trong build chain. - Cảnh báo trước những cạm bẫy thường gặp: build composite có log rỗng, dùng
--limitchứ không phải--count, chỉ đặtTEAMCITY_URLsẽ bỏ qua auth đã lưu,pipeline pushkhông tự validate. - Khuyến nghị thực hành an toàn: kết nối GitHub bằng GitHub App connection thay vì dán Personal Access Token.
Phù hợp với ai
- Kỹ sư DevOps / platform / backend đang dùng TeamCity làm hệ thống CI/CD.
- Nhóm phải mở web UI click nhiều bước mỗi lần build đỏ.
- Người quản lý pipeline dưới dạng code và muốn tự động hoá vòng validate → push.
Ví dụ sử dụng
- "Build này fail vì sao?" →
teamcity run list --status failure, rồirun log <id> --failed --rawghi ra file tạm và tóm tắt nguyên nhân gốc. - Gỡ lỗi build chain:
teamcity run tree <id>để tìm dependency lỗi sâu nhất, sửa xong chạyrun start --watchđể xác nhận. - Cập nhật pipeline:
pipeline pull→ sửa →pipeline validate→pipeline push, tránh đẩy cấu hình sai lên server.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/JetBrains/teamcity-cli/HEAD/skills/teamcity-cli/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/teamcity-cli từ repo GitHub JetBrains/teamcity-cli vào ~/.claude/skills/teamcity-cli/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/JetBrains/teamcity-cli.git /tmp/teamcity-cli && mkdir -p ~/.claude/skills && cp -r /tmp/teamcity-cli/skills/teamcity-cli ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Cài CLI
teamcitycủa JetBrains trước, chạyteamcity auth loginrồi kiểm tra bằngteamcity auth status. - Clone repo:
git clone https://github.com/JetBrains/teamcity-cli.git /tmp/teamcity-cli - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Copy skill:
cp -r /tmp/teamcity-cli/skills/teamcity-cli ~/.claude/skills/ - Kiểm tra thư mục
references/(commands.md, workflows.md, output.md) đã được copy kèm. - Khởi động lại Claude Code và thử: "Kiểm tra vì sao build TeamCity ở URL này bị lỗi".
- Tuỳ chọn: chạy
teamcity linktrong repo để gắn project quateamcity.toml.
Xem mã nguồn trên GitHub ↗Giấy phép: Apache-2.0