Mua ngay
Hướng dẫn cài đặt

Cài qa-kit 1.0.0 trong 4 bước

Tóm tắt từ HUONG-DAN.md đi kèm gói. Bản đầy đủ — câu lệnh hằng ngày, tuỳ biến, xử lý sự cố, quy trình cho team — có trong file zip bạn nhận được.

Đang dùng bản Lite? Xem Bắt đầu với bản dùng thử.

Trong gói có gì

File / thư mụcDùng để
HUONG-DAN.mdĐọc trước: cài đặt, thiết lập dự án và sử dụng từ đầu đến cuối
qa-kit.pluginTải lên app Claude (Customize › Plugins › Add)
qa-kit/Thư mục plugin: mã nguồn skill + tool
.claude-plugin/marketplace.jsonĐể Claude Code cài cả thư mục như 1 marketplace cục bộ
  1. 1

    Chuẩn bị

    Gói Claude trả phí, Python 3.8+ trên máy (Windows dùng WSL hoặc Git Bash), tài khoản Jira + Xray có quyền tạo issue và token. Phần tuỳ chọn (Chrome, Figma, DB chỉ đọc, Node.js…) bật phần nào dùng phần đó — xem danh sách đầy đủ.

  2. 2

    Cài plugin

    App Claude (Chat / Cowork) Khuyến nghị cho QA chạy hằng ngày

    Customize › Plugins › Add › tải lên qa-kit.plugin, rồi bật plugin. Sau đó chat với Claude ở Chat hoặc Cowork như bình thường.

    • App desktop đã nối máy: chạy đầy đủ, kể cả DB/API sau VPN.
    • Bản web / không nối máy: gọi được Jira/Xray/API công khai trên Internet, không vào được DB/API sau VPN công ty.

    Figma: thêm ở Settings › Connectors. Claude in Chrome: cài extension và đăng nhập cùng tài khoản Claude.

    Claude Code Cho ai quen dòng lệnh

    Giải nén zip vào chỗ cố định, VD ~/tools/qa-kit-1.0.0 (đừng xoá hay đổi tên sau khi cài), rồi chạy:

    claude plugin marketplace add ~/tools/qa-kit-1.0.0
claude plugin install qa-kit@qa-kit-marketplace
claude plugin list        # thấy: qa-kit … enabled

    Gõ / trong phiên sẽ thấy /qa-kit:qa-run, /qa-kit:qa-setup… Dùng Chrome: claude --chrome. Chỉ bật cho 1 dự án: thêm --scope project.

  3. 3

    Thiết lập dự án bằng /qa-setup

    Làm 1 lần mỗi dự án. Mở phiên mới và nói “cài qa-kit cho dự án <tên>”. Claude hỏi gộp từng nhóm, có gợi ý sẵn:

    1. Thư mục làm việc: Mặc định ~/QA/<tên-dự-án>; Claude tạo cấu trúc bên dưới.
    2. Jira + Xray: Cloud hay Server/DC, URL, project key, token. Claude tự dò loại issue, tên link, priority, trạng thái workflow và nhờ bạn xác nhận.
    3. Môi trường: URL môi trường test (staging/UAT), URL API, URL production, API có cần token không.
    4. Tuỳ chọn: DB, repo code, Figma, Chrome, nhóm chat, automation, health check, quy chuẩn hiển thị.
    5. Kiểm tổng: Bảng trạng thái từng phần và những việc còn thiếu.
    <WS>/
├── qa-config.json   cấu hình dự án (không chứa mật khẩu/token)
├── qa/              kho QA: báo cáo, quyết định, review… (chia sẻ được)
│   ├── <STORY>/     VD qa/PROJ-100/qa-run-20260115.md, decisions.md
│   ├── context/     bối cảnh dự án, mẫu tin nhắn, quy chuẩn hiển thị
│   ├── adapters/    adapter trang chart
│   ├── health/      cấu hình + báo cáo health check
│   └── automation/  mốc so sánh automation, Bug backlog
├── runs/            file thô từng lượt chạy (bằng chứng, CSV, ảnh)
├── repos/           bản clone riêng cho automation
└── .qa-kit/         tool + file bí mật (KHÔNG chia sẻ, KHÔNG commit)

    Token mặc định được hỏi 1 lần mỗi phiên và chỉ đặt trong lệnh, không lưu file.

  4. 4

    Chạy Story đầu tiên

    Nhắn review PROJ-100 để xem phần soát Story, rồi test PROJ-100 để chạy cả vòng. Ở mỗi điểm dừng, đọc kỹ bản xem trước — đây là lúc bạn chỉnh cách Claude viết test và ghi lỗi cho hợp với team mình.

Danh sách cần có

Thành phầnGhi chú
Gói Claude trả phíPro, Max, Team hoặc Enterprise — plugin chỉ có ở gói trả phí.Bắt buộc
App Claude (Chat / Cowork) hoặc Claude CodeKhuyến nghị app Claude bản desktop (Chat hoặc Cowork) đã nối máy để chạy đầy đủ, kể cả DB/API sau VPN. Quen dòng lệnh thì dùng Claude Code.Bắt buộc
Python 3.8+Tool chỉ dùng thư viện chuẩn. macOS/Linux chạy trực tiếp; Windows dùng WSL hoặc Git Bash.Bắt buộc
Jira + XrayCloud hoặc Server/DC. Quyền tạo issue, comment, chuyển trạng thái. Token Jira (Xray Cloud thêm Client ID + Secret).Bắt buộc
Chrome + Claude in ChromeChạy FUNC/UI, regression, smoke test trên trình duyệt thật đã đăng nhập môi trường test và production.Tuỳ chọn
FigmaSo giao diện. Seat View/Collab có ít lượt gọi — gửi ảnh PNG export thay link cũng được.Tuỳ chọn
DB chỉ đọcPostgreSQL/MySQL của môi trường test (+ VPN nếu cần) để đối soát số liệu, API ↔ DB, health check.Tuỳ chọn
Repo code FE/BEĐọc code để biết endpoint, công thức tính (chỉ đọc).Tuỳ chọn
Node.js 20+, git, ghCho automation Playwright và CI GitHub Actions.Tuỳ chọn
Webhook nhóm chatGoogle Chat, Slack hoặc Teams — gửi tin “Ready for Live” và kết quả smoke test trên production.Tuỳ chọn

Dùng cho cả team

  • Đơn giản: gửi file zip, mỗi người tự cài theo bước 2.
  • App Claude Team/Enterprise: Owner/Admin phân phối ở Organization settings › Plugins & skills.
  • Claude Code: đưa nội dung zip lên 1 repo Git nội bộ, mọi người claude plugin marketplace add <org>/<repo> rồi cài; phát hành bản mới bằng cách tăng version.

Cập nhật và gỡ

  • App Claude: tải lên qa-kit.plugin bản mới hoặc gỡ ở Customize › Plugins.
  • Claude Code: giải nén bản mới đè lên thư mục cũ, hoặc claude plugin update qa-kit@qa-kit-marketplace nếu cài từ repo Git.
  • Kho QA và qa-config.json không bị ảnh hưởng khi cập nhật hay gỡ.

Sự cố hay gặp

Hiện tượngCách xử lý
Nói “test PROJ-100” mà Claude không dùng qa-kitKiểm plugin đã bật (Customize › Plugins / claude plugin list); gọi đích danh /qa-run PROJ-100 (Claude Code: /qa-kit:qa-run PROJ-100).
Jira 401Cloud: sai email hoặc dùng mật khẩu thay vì API token. Server: PAT hết hạn.
DB timeoutBật VPN; kiểm kết nối bằng tool pgq.py --test trong .qa-kit/tools.
Figma hết lượt gọiGửi ảnh PNG export của frame thay cho link.
App Claude bản web không gọi được DB/API nội bộSandbox cloud không vào được mạng công ty — dùng app Claude bản desktop (Chat hoặc Cowork) đã nối máy, hoặc Claude Code.

Có câu hỏi trước khi mua? Xem câu hỏi thường gặp hoặc liên hệ.