HQ

huyphan13189/qe-ai

Developer tools
24 stars Quality 40 Trend 32

Bộ dùng chung cho mọi AI coding assistant: Claude Code, OpenAI Codex, Gemini CLI, Cursor, và các tool khác.

Overview

Bộ dùng chung cho mọi AI coding assistant: Claude Code, OpenAI Codex, Gemini CLI, Cursor, và các tool khác. Mỗi skill có ở .claude/skills/ /SKILL.md. Các file cấu hình riêng của từng tool chỉ là adapter mỏng trỏ về bản gốc đó — sửa skill một lần, tất cả tool dùng chung. Ngoài bộ skill, repo có giúp tester học & ứng dụng AI vào công việc, tổ chức theo level năng lực (Foundation → Practitioner → Builder): curriculum/README.md. Có 2 cách cài: rồi làm việc trực tiếp trong đó — mọi adapter đã sẵn sàng. Hoặc theo hướng dẫn dưới đây. - không cần làm gì — skill tự được nhận diện, gọi qua Skill tool. - copy cả thư mục .claude/skills/auditing-test-quality/ vào project, hoặc vào global ~/.claude/skills/ để dùng ở mọi nơi. Codex đọc file AGENTS.md tự động (project root, và global ~/.codex/AGENTS.md). - đã có sẵn AGENTS.md. - copy AGENTS.md + thư mục .claude/skills/ vào project. Nếu không muốn giữ thư mục skill, dán thẳng nội dung SKILL.md vào AGENTS.md. Gemini nạp GEMINI.

README

QE-AI

Bộ skill Quality Engineering (QE) dùng chung cho mọi AI coding assistant: Claude Code, OpenAI Codex, Gemini CLI, Cursor, và các tool khác.

Mỗi skill có một bản gốc duy nhất ở .claude/skills//SKILL.md. Các file cấu hình riêng của từng tool chỉ là adapter mỏng trỏ về bản gốc đó — sửa skill một lần, tất cả tool dùng chung.

Skill hiện có

Skill Dùng khi nào
auditing-test-quality Audit / đánh giá chất lượng & độ phủ của một test suite hiện có — truy tìm fake test và rủi ro chưa được test. Không dùng để viết test mới.
generating-test-cases Sinh / thiết kế test case từ requirement, user story hoặc spec API/UI bằng AI — ép đủ chiều phủ, cắt case bịa/trùng, kiểm chứng với spec/app thật.
prompting-for-qe Soạn / tinh chỉnh prompt cho tác vụ QE khi output lan man / bịa / không dùng được, hoặc chuẩn hóa prompt thành template.
designing-test-strategy Lập kế hoạch test / test charter cho một tính năng — ưu tiên theo rủi ro, nêu out-of-scope, không liệt kê tràn lan.
writing-automation-tests Viết / bảo trì automation test (API/UI) có AI hỗ trợ — bảo đảm test FAIL đúng lúc có bug, selector bền.
generating-test-data Sinh test data đa dạng (biên, unicode, bulk) đúng schema và an toàn — không dùng dữ liệu prod.
analyzing-bugs-and-logs Phân tích log / stacktrace để khoanh nguyên nhân, triage, và viết bug report tái hiện được — coi nguyên nhân AI đưa là giả thuyết.
writing-qe-skills Đóng gói một quy trình QE lặp lại thành skill dùng chung của repo (bản gốc + adapter).
building-test-tools-with-api Xây công cụ QE tự động bằng cách gọi Claude API/SDK — key từ ENV, không hard-code model, có xử lý lỗi.
writing-e2e-tests Viết/sửa e2e test golden-path (browser→API→DB) — spine reset→seed→auth-bypass→enter→assert, deep-link qua entry bị gate, change-impact khi code đổi, reuse scale (helper→fixtures→POM).
planning-e2e-coverage Lập kế hoạch e2e cho codebase — sweep journey, xếp hạng rủi ro (main flow trước), baseline flow đã có e2e, phân tầng LOW/MED/HIGH, roadmap mở rộng.
capturing-ui-sweep Chụp ảnh toàn bộ UI để tự review layout lệch/vỡ, thiếu data, empty-state xấu, UX — visual QA sweep gom ảnh theo tính năng (registry→runner→index) rồi chạy một lượt AI soi lỗi. Chỉ báo cáo, không sửa UI.
managing-seed-data Dựng/mở rộng seed data local thành thư viện fixtures dùng chung cho CLI seed dev + e2e — builder/scenario, PROD guard fail-closed, và giữ idempotent (bẫy: row của user POV cộng dồn mỗi lần chạy).
coaching-qe-learners Kèm học viên đi theo curriculum — định vị cửa đang đứng, giao bài, chấm theo bằng chứng thật (không có file thì không tick), và phỏng vấn 3 tầng để quyết định lên level. Không làm hộ bài của học viên.

Lộ trình học AI cho Tester

Ngoài bộ skill, repo có lộ trình đào tạo giúp tester học & ứng dụng AI vào công việc, tổ chức theo level năng lực (Foundation → Practitioner → Builder): curriculum/README.md.

Cấu trúc repo

.
├── .claude/skills//SKILL.md   # BẢN GỐC của skill (nguồn chân lý)
├── AGENTS.md                             # Adapter cho Codex (và chuẩn AGENTS.md chung)
├── GEMINI.md                             # Adapter cho Gemini CLI
├── .cursor/rules/*.mdc                   # Adapter cho Cursor
├── .windsurf/rules/*.md                  # Adapter cho Windsurf
├── .github/copilot-instructions.md       # Adapter cho GitHub Copilot
└── README.md

Cách dùng cho từng AI

Có 2 cách cài: (A) Clone repo này rồi làm việc trực tiếp trong đó — mọi adapter đã sẵn sàng. Hoặc (B) Copy skill vào project của bạn theo hướng dẫn dưới đây.

Claude Code

  • Trong repo này: không cần làm gì — skill tự được nhận diện, gọi qua Skill tool.
  • Vào project của bạn: copy cả thư mục .claude/skills/auditing-test-quality/ vào project, hoặc vào global ~/.claude/skills/ để dùng ở mọi nơi.
cp -r .claude/skills/auditing-test-quality ~/.claude/skills/

OpenAI Codex CLI

Codex đọc file AGENTS.md tự động (project root, và global ~/.codex/AGENTS.md).

  • Trong repo này: đã có sẵn AGENTS.md.
  • Vào project của bạn: copy AGENTS.md + thư mục .claude/skills/ vào project. Nếu không muốn giữ thư mục skill, dán thẳng nội dung SKILL.md vào AGENTS.md.

Gemini CLI

Gemini nạp GEMINI.md làm context (project root, và global ~/.gemini/GEMINI.md).

  • Trong repo này: đã có sẵn GEMINI.md.
  • Vào project của bạn: copy GEMINI.md + thư mục .claude/skills/, hoặc dán nội dung SKILL.md thẳng vào GEMINI.md.

Cursor

Cursor dùng rule dạng .cursor/rules/*.mdc (kích hoạt theo description).

  • Trong repo này: đã có sẵn .cursor/rules/auditing-test-quality.mdc.
  • Vào project của bạn: copy thư mục .cursor/rules/ + .claude/skills/, hoặc dán nội dung SKILL.md thẳng vào file .mdc.

Windsurf

Windsurf dùng rule dạng .windsurf/rules/*.md (kích hoạt theo trigger: model_decision + description).

  • Trong repo này: đã có sẵn .windsurf/rules/auditing-test-quality.md.
  • Vào project của bạn: copy thư mục .windsurf/rules/ + .claude/skills/, hoặc dán nội dung SKILL.md thẳng vào file .md.

GitHub Copilot

Copilot đọc .github/copilot-instructions.md làm chỉ dẫn mức repo.

  • Trong repo này: đã có sẵn .github/copilot-instructions.md.
  • Vào project của bạn: copy file này + thư mục .claude/skills/, hoặc dán nội dung SKILL.md thẳng vào file.

Tool khác

Cùng một khuôn mẫu — tạo file “instruction/rule” của tool đó rồi trỏ về, hoặc dán thẳng nội dung .claude/skills/auditing-test-quality/SKILL.md.

Nguồn chân lý & cách cập nhật

Chỉ sửa nội dung skill ở .claude/skills//SKILL.md. Các adapter chỉ trỏ tới file này nên không cần sửa theo. Nếu ở project của bạn bạn dán thẳng nội dung skill vào file config của tool (thay vì trỏ), nhớ đồng bộ lại khi bản gốc thay đổi.

Thêm skill mới

  1. Tạo .claude/skills//SKILL.md (có frontmatter name + description).
  2. Thêm dòng trỏ tới nó trong AGENTS.md, GEMINI.md, .github/copilot-instructions.md, và một file rule cho .cursor/rules/.mdc + .windsurf/rules/.md.
  3. Thêm một dòng vào bảng “Skill hiện có” ở trên.
View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add huyphan13189/qe-ai