Metadata-Version: 2.4
Name: huynp-skills
Version: 1.2.2
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 & Secure QA Prompt Skill Manager** — Quản lý bộ kỹ năng QA tập trung, đóng gói mã hoá prompt để bảo vệ chất xám và tối ưu cho AI Agents (Antigravity).

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

---

## 🌟 Phá vỡ rào cản chia sẻ Prompt
Phiên bản **v1.2.1** mang đến bước đột phá về bảo mật và tiện dụng:
1. **Kiến trúc ẩn (Embedded Core):** Toàn bộ "bộ não" prompts (`_core`) đã được mã hoá và đóng gói trực tiếp vào thư viện.
2. **Bundled Examples:** Các ví dụ mẫu đã được đóng gói kèm thư viện để Agent tham chiếu mọi lúc.
3. **Lệnh rút gọn (Short IDs):** Hỗ trợ gọi skill/example bằng tên ngắn (VD: `ui-checklist`, `example-login-feature`).
4. **Local Overrides:** Hệ thống ưu tiên đọc file ví dụ tại dự án local (`01_knowledge_base/examples/`) nếu bạn muốn tùy biến mẫu riêng.

---

## 🚀 Cài Đặt Miễn Phí (Quick Start)

Mở Terminal của bạn (khuyến khích dùng trong môi trường ảo - venv) và chạy:

```bash
pip install huynp-skills
```

---

## 🛠️ Quy Trình Làm Việc Chuẩn

### Bước 1: Khởi tạo dự án
Di chuyển vào thư mục dự án kiểm thử của bạn và khởi tạo template:
```bash
huynp-skills init
```
Lệnh này sẽ tự động tạo cấu trúc thư mục tiêu chuẩn (`01_knowledge_base`, `03_test_design`, file Workflow cho Agent...).

### Bước 2: Xem danh sách kỹ năng
Bạn có thể xem tất cả các kịch bản kiểm thử (prompts) đã được đóng gói sẵn trong phiên bản này:
```bash
huynp-skills list
```

### Bước 3: Sử dụng với AI Agent (Antigravity)
Khi bạn cần Agent thực hiện một nhiệm vụ (ví dụ: Tạo UI Checklist), bạn hãy chỉ định Agent chạy lệnh sau:
```bash
huynp-skills context ui-checklist -i 01_knowledge_base/requirements/prd_login.md
```
Tool sẽ tự động:
- Giải mã prompt ngầm.
- Ghép nối với tài liệu đầu vào của bạn.
- Xuất ra "Brief" hoàn chỉnh để AI Agent hiểu và thực hiện nhiệm vụ ngay lập tức.

---

## 📋 Danh Sách Lệnh (Command Reference)

| Lệnh | Ý nghĩa |
|---|---|
| `huynp-skills init` | Thiết lập dự án mới (Templates, Workflows, Folder structure) |
| `huynp-skills list` | Liệt kê tất cả Prompt Skills đã được mã hoá bên trong package |
| `huynp-skills context <id>` | Biên dịch kỹ năng + input thành ngữ cảnh cho AI (Ẩn kịch bản gốc) |
| `huynp-skills status` | Xem trạng thái thống kê của project hiện tại |
| `huynp-skills kb list` | Xem danh sách tài liệu trong Knowledge Base cá nhân |

---

## 🏗️ Cấu Trúc Dự Án (Sau khi init)

```
my-project/
├── .agents/workflows/
│   └── qc_follow.md          ← Workflow cho Antigravity (Sử dụng lệnh CLI)
├── Master_Instruction.md      ← Project context (Nơi bạn cập nhật scope dự án)
├── 01_knowledge_base/
│   └── requirements/         ← Nơi bạn đặt PRD / Rule của khách hàng
└── 03_test_design/           ← Nơi AI Agent xuất kết quả sau khi làm việc
    ├── manual/checklist/     
    ├── manual/test_cases/    
    └── automation/scripts/    
```

---

## Dành cho Developers (Đóng góp Prompt)
Nếu bạn là người quản lý Framework và muốn cập nhật Prompt mới:
1. Thêm/Sửa Markdown trong thư mục `_core/02_prompts`.
2. Chạy script `python scripts/bundle_core.py` để đóng gói lại file nhị phân.
3. Nâng version trong `pyproject.toml` và publish.

---

## License
MIT
