Hướng dẫn Nhanh

Bắt đầu lập trình và sửa lỗi cùng PrimeKit thông qua cú pháp gọi slash command chuẩn hóa.

Cách gọi Skills

Trong Claude Code, gọi skill bằng /pk:<skillName> (tên thư mục /pk-<skillName> cũng gọi được). Cursor và Antigravity dùng /pk-<skillName>; Codex dùng $pk-<skillName> (hoặc chọn qua /skills); Gemini CLI tự kích hoạt skill phù hợp và liệt kê qua /skills. Ví dụ trong Claude Code:

/pk:explore Khảo sát dự án và vẽ sơ đồ các component xác thực người dùng.

/pk:plan Lập kế hoạch từng bước nâng cấp lên phiên bản OAuth2 mới.

/pk:debug Khắc phục lỗi rò rỉ bộ nhớ trong tiến trình background worker.

Phạm vi Global vs Workspace

Hiểu rõ sự khác biệt giữa cài đặt toàn hệ thống và cài đặt cô lập theo từng thư mục dự án.

Cài đặt theo Dự án (Workspace Isolation)

Câu lệnh: npx @lovehlmmm/primekit init
Cài skills vào ./.claude/skills/ và ./.agents/skills/, thêm mục PrimeKit vào ./AGENTS.md và ghi manifest tại ./.primekit/manifest.json. Thích hợp cho các dự án làm việc nhóm quản lý qua Git.

Cài đặt Toàn cục (Global System Scope)

Câu lệnh: npx @lovehlmmm/primekit init -g
Cài skills vào thư mục cá nhân của các trợ lý được phát hiện trên máy (với --assistant all mặc định), manifest tại ~/.primekit/manifest.json, không ghi file hướng dẫn nào. Gỡ bằng pk uninstall -g:

Universal Adapter Pattern

PrimeKit đồng nhất hóa năng lực của các trợ lý AI mà không phụ thuộc vào nhà cung cấp: cùng một bộ skill, cài theo quy ước của từng runtime. Claude Code giữ tên pk:<skill> trong frontmatter nên lệnh vẫn là /pk:<skill>; các runtime còn lại theo chuẩn Agent Skills (tên chỉ gồm [a-z0-9-] và phải trùng tên thư mục) nên tên được đổi thành pk-<skill> lúc cài.

Quy tắc điều hướng AGENTS.md

PrimeKit thêm một mục router rules vào AGENTS.md ở gốc dự án, giữ nguyên nội dung của bạn. Codex, Cursor và Antigravity đọc file này trực tiếp; Claude Code chỉ tự đọc khi dự án không có CLAUDE.md, .claude/CLAUDE.md hay CLAUDE.local.md (nếu có, PrimeKit thêm dòng import @AGENTS.md vào file đó); Gemini CLI chỉ đọc khi settings có {"context":{"fileName":["AGENTS.md","GEMINI.md"]}}, PrimeKit không sửa settings của bạn.

8-Core Workflow Pipeline

Đối với các tác vụ lập trình phức tạp (>2 tập tin thay đổi), PrimeKit áp dụng quy trình 8 bước tự động hóa khép kín có đo lường kiểm chứng nghiệm thu:

Bảng Tra Cứu Lệnh CLI

Danh sách đầy đủ các câu lệnh của công cụ primekit (tên viết tắt pk).

primekit init                Cài PrimeKit vào dự án hiện tại
primekit init -g             Cài toàn cục cho các trợ lý được phát hiện trên máy
primekit list                Liệt kê skills đã cài theo từng thư mục skills
primekit doctor              Kiểm tra SHA256, tính hợp lệ của skill và các trợ lý đã cài
primekit update              Đồng bộ với phiên bản gói hiện tại (giữ file bạn đã sửa)
primekit import <skill>      Import thư mục skill (mặc định từ ~/.gemini/config/skills)
primekit uninstall           Chỉ gỡ các file và mục PrimeKit đã cài (thêm -g cho bản toàn cục)

--global, -g                 Dùng thư mục người dùng (~/.claude/skills, ~/.agents/skills, ...)
--assistant <id>             claude, codex, cursor, gemini, antigravity, antigravity-cli,
                             all (mặc định) hoặc danh sách cách nhau bằng dấu phẩy
--dry-run                    Xem trước thay đổi, không ghi file
--force                      Sao lưu (<file>.bak.<timestamp>) rồi thay/xóa file bạn đã sửa
--from <dir>                 Thư mục nguồn cho import
--all                        Import mọi thư mục skill trong nguồn
--version, -v                In phiên bản
--help, -h                   Hiển thị trợ giúp

An toàn khi chạy lại: init/update không ghi lại file đã giống hệt và không tạo bản sao lưu; file PrimeKit đã cài mà bạn chưa sửa được cập nhật tại chỗ; file bạn đã sửa (hoặc file lạ nằm ở đường dẫn của PrimeKit) được giữ nguyên và báo là conflict; --force sao lưu chúng thành <file>.bak.<timestamp> rồi mới thay/xóa. Skill đã import (vào mọi thư mục skills đã cài, dưới tên pk-<tên>) được pk update giữ lại. uninstall chỉ xóa file có trong manifest và còn khớp checksum, chỉ gỡ mục PrimeKit khỏi file dùng chung (chỉ xóa file nếu PrimeKit tạo ra nó và giờ đã trống), dọn thư mục rỗng và giữ file bạn đã sửa (manifest được giữ để uninstall --force gỡ sau). Không có manifest thì uninstall không đụng tới gì.

Chẩn đoán Sức khỏe (pk doctor)

Kiểm tra SHA256 của từng file, tính hợp lệ của từng thư mục skill (có frontmatter, không có UTF-8 BOM, tên đúng quy tắc của runtime, description ≤ 1024 ký tự, đủ 8 core skills), mục PrimeKit trong các file hướng dẫn, các trợ lý được phát hiện trên máy, và với Codex kiểm tra thực tế qua codex debug prompt-input (không gọi model) rằng catalog đã nạp đủ 8 core skills.

primekit doctor

Cấu hình Claude Code CLI

Hướng dẫn tích hợp PrimeKit vào Claude Code CLI của Anthropic.

Chạy pk init để cài vào .claude/skills/pk-<skill>/ của dự án, hoặc pk init -g để cài vào ~/.claude/skills/ (hoặc $CLAUDE_CONFIG_DIR/skills) cho mọi phiên làm việc. Gọi skill bằng /pk:<skill>, ví dụ /pk:explore (tên thư mục /pk-explore cũng gọi được). Nếu dự án có CLAUDE.md, .claude/CLAUDE.md hoặc CLAUDE.local.md thì Claude Code không tự đọc AGENTS.md, nên PrimeKit thêm vào file đó một mục PrimeKit chứa @AGENTS.md (hoặc @../AGENTS.md với .claude/CLAUDE.md).

Cấu hình Cursor IDE

Hướng dẫn tích hợp PrimeKit với Agent Skills của Cursor.

PrimeKit cài skill vào .agents/skills/pk-<skill>/ (toàn cục: ~/.agents/skills/) và đặt router rules trong AGENTS.md. Gọi skill bằng /pk-<skill>, ví dụ /pk-explore. Cursor cũng đọc .claude/skills để tương thích, nên khi có cả hai thư mục một skill có thể hiện hai lần; nếu chỉ dùng Cursor, hãy cài bằng pk init --assistant cursor. PrimeKit không còn ghi .cursorrules hay ~/.cursor/rules (thư mục này không nạp thư mục skill).

Cấu hình Antigravity / Gemini CLI

Hướng dẫn tích hợp vào Google Antigravity (2.0/IDE/CLI) & Gemini CLI.

Trong dự án, cả hai dùng chung .agents/skills/pk-<skill>/. Antigravity gọi skill bằng /pk-<skill> và đọc AGENTS.md. Gemini CLI (cần v0.26+) tự kích hoạt skill phù hợp (activate_skill), liệt kê qua /skills, bỏ qua skill của workspace trong thư mục chưa được tin cậy (untrusted), và chỉ đọc AGENTS.md khi settings có {"context":{"fileName":["AGENTS.md","GEMINI.md"]}} (PrimeKit không sửa settings của bạn). Khi cài toàn cục: Antigravity 2.0/IDE dùng ~/.gemini/config/skills/, Antigravity CLI dùng ~/.gemini/antigravity-cli/skills/ (chỉ khi có agy hoặc settings.json của nó), Gemini CLI dùng ~/.agents/skills/.