跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

skills-jira-integration

Skill tích hợp Jira/Xray — lấy requirements từ Jira, xác thực Xray, và đẩy kết quả test lên Xray Cloud/Server.

anhtester · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add anhtester/claude-testing-kit --skill skills-jira-integration

技能说明


name: skills-jira-integration description: Skill tích hợp Jira/Xray — lấy requirements từ Jira, xác thực Xray, và đẩy kết quả test lên Xray Cloud/Server.

Jira & Xray Integration Skill

Mô tả

Skill này cung cấp khả năng tích hợp giữa Claude Testing Skills với hệ thống Jira và Xray để:

  1. Lấy Requirements/User Stories từ Jira → chuyển thành tài liệu yêu cầu chuẩn
  2. Xác thực Xray (Cloud hoặc Server/Data Center)
  3. Đẩy kết quả test (Playwright, JUnit, Allure) lên Xray Test Management

Khi nào sử dụng

Agent sử dụng skill này khi user yêu cầu:

  • Lấy requirement / user story từ Jira
  • Kết nối / test connection đến Jira API
  • Đẩy kết quả test lên Xray
  • Import test results lên Jira
  • Xác thực Xray token
  • Tích hợp CI/CD với Jira

Trigger keywords:

  • "fetch jira", "lấy requirement từ jira", "get jira ticket"
  • "import xray", "đẩy kết quả lên xray", "push test results"
  • "test jira connection", "kiểm tra kết nối jira"

Cấu trúc Scripts

scripts/integrations/
├── jira/
│   ├── jira_fetcher.js      # Lấy Requirement/User Story từ Jira
│   ├── xray_auth.js         # Xác thực và lấy Token Xray
│   ├── xray_importer.js     # Import kết quả test lên Xray
│   └── utils.js             # Hàm utility dùng chung
└── package.json             # Dependencies (axios, dotenv)

Điều kiện tiên quyết (Prerequisites)

1. Cài đặt dependencies

cd scripts/integrations
npm install

2. Cấu hình .env

Copy .env.example thành .env ở thư mục gốc project:

cp .env.example .env

Điền các thông tin bắt buộc:

BiếnMô tảBắt buộc
JIRA_BASE_URLURL Jira instance (VD: https://domain.atlassian.net)✅
JIRA_EMAILEmail tài khoản Jira (Cloud)✅ (Cloud)
JIRA_API_TOKENAPI Token (Cloud)✅ (Cloud)
JIRA_PATPersonal Access Token (Server/DC)✅ (Server)
JIRA_PROJECT_KEYProject key mặc địnhKhuyến nghị
XRAY_PLATFORMcloud hoặc serverMặc định: cloud
XRAY_CLIENT_IDXray API Client IDKhi dùng Xray Cloud
XRAY_CLIENT_SECRETXray API Client SecretKhi dùng Xray Cloud

3. Cách lấy Jira API Token (Cloud)

  1. Đăng nhập vào https://id.atlassian.com/manage-profile/security/api-tokens
  2. Nhấn Create API token
  3. Đặt label (VD: "Claude Automation")
  4. Copy token → dán vào JIRA_API_TOKEN trong file .env

4. Cách lấy Xray Cloud API Key

  1. Truy cập https://app.getxray.app → Settings → API Keys
  2. Hoặc trong Jira: Apps → Xray → Settings → API Keys
  3. Tạo API Key mới → Copy Client ID và Client Secret

Hướng dẫn sử dụng

Lấy 1 issue cụ thể

node scripts/integrations/jira/jira_fetcher.js --issue PROJ-123

Lấy issues theo project

node scripts/integrations/jira/jira_fetcher.js --project PROJ --type Story --max 20

Tìm theo JQL

node scripts/integrations/jira/jira_fetcher.js --jql "project = PROJ AND status = 'To Do'"

Xuất thành Markdown requirement

node scripts/integrations/jira/jira_fetcher.js --issue PROJ-123 --format md

Lấy children của Epic

node scripts/integrations/jira/jira_fetcher.js --epic PROJ-10 --format md

Test Xray authentication

node scripts/integrations/jira/xray_auth.js
node scripts/integrations/jira/xray_auth.js --verify

Import kết quả Playwright lên Xray

node scripts/integrations/jira/xray_importer.js --format playwright --file ./test-results.json --project PROJ

Import JUnit XML lên Xray

node scripts/integrations/jira/xray_importer.js --format junit --file ./junit-results.xml --project PROJ

Workflow liên quan

WorkflowMô tả
/fetch_jira_requirementsLấy requirements từ Jira ticket và lưu thành file
/import_test_results_xrayĐẩy kết quả test lên Xray

Lưu ý quan trọng

  • Bảo mật: KHÔNG bao giờ commit file .env lên Git. File .gitignore đã được cấu hình bỏ qua .env.
  • Rate Limiting: Jira Cloud có giới hạn API calls. Script đã hỗ trợ phân trang (pagination) để tránh vượt limit.
  • Atlassian Document Format (ADF): Jira Cloud sử dụng ADF cho description. Script tự động chuyển đổi ADF → plain text.
  • Test Key Convention: Khi import Playwright results, nên đặt test key trong title: test('[PROJ-123] Login should work', ...) để Xray mapping đúng test case.

Troubleshooting

LỗiNguyên nhânGiải pháp
HTTP 401Token/password saiKiểm tra JIRA_API_TOKEN hoặc JIRA_PAT
HTTP 403Không có quyềnKiểm tra permission trên Jira project
HTTP 404URL sai hoặc issue không tồn tạiKiểm tra JIRA_BASE_URL và issue key
ENOTFOUNDDNS không resolveKiểm tra JIRA_BASE_URL có đúng domain không
ECONNREFUSEDServer không chạyKiểm tra Jira Server có online không
File .env not foundChưa tạo .envCopy .env.example → .env