Metadata-Version: 2.4
Name: huynp-skills
Version: 1.0.9
Summary: QA Prompt Skill Manager — centralized prompt hub for QA/QC teams
Author-email: nphuy_1995 <bobo.pro.dn@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/huynp/huynp-skills
Project-URL: Repository, https://github.com/huynp/huynp-skills
Keywords: qa,qc,testing,prompt,skills,test-case
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Testing
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: colorama>=0.4

# 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.

[![PyPI version](https://badge.fury.io/py/huynp-skills.svg)](https://badge.fury.io/py/huynp-skills)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

---

## 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:

```bash
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:**
  ```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:**
  ```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ụ:
```bash
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:
```bash
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!
```bash
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:

```bash
# 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ý. <br>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
