huynp-skills 1.2.1

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

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

---

🌟 Phá vỡ rào cản chia sẻ Prompt

Phiên bản v1.2.0 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:

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:

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:

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:

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