huynp-skills 1.0.9

QA Prompt Skill Manager — centralized prompt hub for QA/QC teams

huynp-skills (QA Framework & Prompt Manager)

Centralized QA Prompt Skill Manager — Quản lý bộ skill prompts QA tập trung cho nhiều project, tái sử dụng 100% kịch bản kiểm thử, đồng thời bảo mật được bộ kỹ năng cốt lõi.

---

Giải quyết bài toán phân mảnh Prompt

Khi đưa AI vào kiểm thử, các nhóm thường gặp vấn đề copy-paste prompt khắp nơi. Framework này giải quyết bằng cách tách biệt nguồn kỹ năng (Hub) và dự án (Project):

1. _core/ (Bảo mật & Tập trung): "Bộ não" chứa toàn bộ system role, prompt mẫu, tool config. Phần này CỐ TÌNH KHÔNG public lên PyPI để phòng trừ rò rỉ dữ liệu, mà được quản lý riêng ở Git nội bộ của team.
2. Package huynp-skills (CLI Tool): Thư viện cài qua pip đóng vai trò công cụ điều phối, kết nối, tạo template tự động cho các project test để người dùng áp dụng bộ kỹ năng trong _core dễ nhất.

---

🚀 Hướng Dẫn Cài Đặt (Dành cho Máy Mới)

Vì file kỹ năng lõi không có trên PyPI, để công cụ hoạt động, các thành viên trong team cần làm theo 3 bước sau:

Bước 1: Clone bộ kỹ năng lõi (_core)

Bạn cần tải mã nguồn (Git clone) repository chứa thư mục _core nội bộ của team về một thư mục bất kỳ trên máy.

Ví dụ lưu tại thư mục: D:\testing-skills\_core

Bước 2: Cài đặt thư viện CLI

Mở Terminal/CMD, kích hoạt môi trường ảo (venv) của dự án bạn đang làm, sau đó cài đặt package:

pip install huynp-skills

Bước 3: Đấu nối thư viện với _core (Set Hub)

Để công cụ nhận biết _core đang nằm ở đâu, bạn thực hiện 1 trong 3 cách:

🟢 Cách 1: Set biến môi trường (Khuyến Cáo)

Thiết lập đường dẫn trỏ thẳng đến _core thông qua biến QA_SKILLS_HUB.

• Windows PowerShell:

  $env:QA_SKILLS_HUB = 'D:\testing-skills\_core'
  

  (Để lưu vĩnh viễn không cần gõ lại, hãy vào Environment Variables của Windows để thêm biến System/User)
• Linux/Mac/Git Bash:

  export QA_SKILLS_HUB=/your/path/to/testing-skills/_core
  

🟡 Cách 2: Set Hub Thủ Công qua CLI

Chạy trực tiếp dòng lệnh cung cấp đường dẫn tuyệt đối tới công cụ:

huynp-skills hub set D:\testing-skills\_core

🟡 Cách 3: Tự động tìm kiếm (Auto-detect)

Nếu folder dự án nằm chung hoặc ở dưới thư mục cha chứa _core, công cụ có thể tự tìm kiếm:

huynp-skills hub auto-detect

✅ Kiểm tra cài đặt thành công: Chạy lệnh bên dưới, nếu bạn thấy trình bày ra danh sách các prompts, Setup đã hoàn thành!

huynp-skills list

---

🛠️ Trình Tự Sử Dụng Hằng Ngày

Khi bạn cần thực hiện công việc cho một dự án test hoặc tính năng mới:

# 1. Đi tới thư mục dự án
cd D:\my-new-project

# 2. Khởi tạo template rỗng
huynp-skills init

Lệnh init sẽ tự động sinh cấu trúc kiểm thử chuẩn:

my-project/
├── .agents/
│   └── workflows/
│       └── qc_follow.md          ← Workflow AI (tự động load paths đến thư mục hub)
├── .huynp-skills                 ← Cấu hình config dự án 
├── Master_Instruction.md         ← Cập nhật Context, scope và tổng quan dự án vào đây
├── 01_knowledge_base/
│   └── requirements/             ← Đặt PRD / Rule / SRS cần để sinh test cases tại đây
└── 03_test_design/               ← Nơi xuất kết quả sinh ra của AI tương ứng
    ├── manual/
    │   ├── checklist/            
    │   └── test_cases/           
    └── automation/scripts/       

Các lệnh tương tác lấy Prompt:

Command	Mô tả
huynp-skills list	Xem lại toàn bộ kỹ năng có sẵn từ Hub
huynp-skills path <id>	Lấy tuyệt đối Path của kỹ năng để truyền đưa cho công cụ AI xử lý. VD: huynp-skills path generate/manual/checklist/ui-checklist
huynp-skills status	Xem trạng thái hệ thống: trạng thái hub đang kết nối và thống kê project hiện tại
huynp-skills kb list	Liệt kê nhanh danh sách file có trong Knowledge Base

---

License

MIT