PrimeKit: 148 skill cho Claude Code, Cursor, Codex, cầm tay một ticket đi qua 8 bước
Bạn giao cho AI agent một ticket: "API danh sách đơn hàng cần lọc theo khoảng ngày". Mười phút sau nó báo xong. Bạn mở ra: nó tự thêm một thư viện xử lý ngày, đổi tên vài hàm "cho rõ nghĩa", không viết test, và đơn đặt lúc 23 giờ ngày cuối tháng bị lọc mất. Chạy được, nhưng sai, và bạn mất nửa tiếng để dọn.
PrimeKit là bộ skill mình làm ra để agent không làm việc kiểu đó. Nó cài 148 skill vào Claude Code, Cursor, Codex, Gemini CLI và Antigravity, xoay quanh một quy trình 8 bước: khảo sát, làm rõ yêu cầu, lập kế hoạch, code, debug, test, review, bàn giao. Mỗi bước có đầu ra rõ ràng và phải có bằng chứng, không chỉ là "xong rồi".
Bài này không liệt kê tính năng. Mình lấy đúng ticket ở trên, cho nó đi qua từng bước, gõ gì và agent trả về gì. Sau đó là các usecase khác ngoài 8 bước, cách cài, và khi nào không cần dùng.
Cài trong một lệnh
Cần Node.js. Chạy ở thư mục gốc của project:
npx @lovehlmmm/primekit init
Lệnh này cài mỗi skill thành một thư mục pk-<tên skill> đúng chỗ từng công cụ đọc, và thêm một mục PrimeKit vào AGENTS.md (nội dung bạn đã viết trong file được giữ nguyên):
| Công cụ | Thư mục skill trong project | Cách gọi |
|---|---|---|
| Claude Code | .claude/skills/ |
/pk:explore |
| Cursor, Antigravity | .agents/skills/ |
/pk-explore |
| Codex | .agents/skills/ |
$pk-explore |
| Gemini CLI | .agents/skills/ |
Tự kích hoạt theo mô tả skill |
Muốn dùng cho mọi project thì cài một lần ở cấp máy: npx @lovehlmmm/primekit init --global. Chỉ cài cho vài công cụ và xem trước sẽ thay đổi những gì: npx @lovehlmmm/primekit init --assistant claude,codex --dry-run.
Các ví dụ dưới đây dùng cú pháp của Claude Code. Agent cũng tự chọn skill theo mô tả, nên nhiều khi bạn không cần gõ tên skill.
Một ticket đi qua 8 bước
Bối cảnh: một API ASP.NET Core, endpoint GET /orders hiện chỉ lọc được theo trạng thái. Ticket yêu cầu thêm lọc theo khoảng ngày cho màn hình quản trị. Các đoạn "agent trả về" bên dưới là minh hoạ rút gọn, để bạn thấy mỗi bước ra cái gì.
explore → clarify → plan → implement → debug → test → review → handoff
xem hỏi đúng kế code tìm gốc chạy soi bàn giao
trước chỗ hoạch kèm test lỗi thật diff cho phiên sau
Bước 1: explore, xem trước khi sửa
/pk:explore lần theo endpoint GET /orders từ controller tới câu query
Agent không đọc cả repo, chỉ lần theo đúng luồng được hỏi, và tách rõ chỗ đã đọc thật với chỗ đang đoán:
GET /orders
→ OrdersController.GetOrders src/Api/Controllers/OrdersController.cs
→ OrderQueryService.SearchAsync src/Application/Orders/OrderQueryService.cs
→ OrderFilter (record: Status, Page) src/Application/Orders/OrderFilter.cs
Test: tests/Api.Tests/OrdersEndpointTests.cs
Lệnh test: dotnet test (đọc từ cấu hình project)
Quy ước: filter là record bất biến, lỗi trả về dạng ProblemDetails
Chưa rõ: cột CreatedAt lưu UTC hay giờ địa phương?
Skill này không cài thêm thư viện, không chạy script lạ, không sửa code. Nó chỉ trả về một bản đồ ngắn để bước sau dựa vào.
Bước 2: clarify, hỏi đúng những gì không đoán được
/pk:clarify
Agent tự đọc code trước, chỉ hỏi những quyết định làm thay đổi kết quả, tối đa ba câu, mỗi câu kèm lựa chọn nó đề xuất:
1. "Đến ngày 30/11" có tính cả đơn đặt trong ngày 30/11 không? (đề xuất: có)
2. Ngày lọc theo giờ Việt Nam hay UTC? CreatedAt đang lưu UTC. (đề xuất: giờ VN, đổi sang UTC khi query)
3. Có giới hạn độ dài khoảng ngày không? (đề xuất: tối đa 366 ngày)
Ba câu này chính là ba chỗ agent ở đầu bài đã đoán sai.
Bước 3: plan, kế hoạch vừa đủ
/pk:plan --fast thêm lọc khoảng ngày cho GET /orders
Việc nhỏ thì kế hoạch ngắn ngay trong cuộc trò chuyện. Việc nhiều bước thì kế hoạch được ghi ra file plans/<ngày>-<tên việc>/plan.md:
Sửa: OrderFilter (thêm From, To), OrderQueryService.SearchAsync, OrdersController (validate)
Thêm test: tính cả ngày cuối, from > to trả 400, khoảng > 366 ngày trả 400
Xong khi: test mới xanh, toàn bộ test cũ vẫn xanh
Bước 4: implement, code kèm test
/pk:implement --tdd
Với --tdd, agent viết test đỏ trước rồi mới sửa code. Test cho đúng chỗ dễ sai nhất:
[Fact]
public async Task Loc_theo_khoang_ngay_tinh_ca_don_cuoi_ngay_ket_thuc()
{
// Đơn đặt lúc 23:30 ngày 30/11 giờ Việt Nam
await SeedOrderAsync(createdAt: new DateTimeOffset(2026, 11, 30, 23, 30, 0, TimeSpan.FromHours(7)));
var page = await Client.GetFromJsonAsync<PagedResult<OrderDto>>(
"/orders?from=2026-11-01&to=2026-11-30");
Assert.Single(page!.Items);
}
Skill này giữ nguyên các thay đổi đang dở của bạn, sửa ít nhất có thể theo quy ước sẵn có, và không tự commit hay push.
Bước 5: debug, tìm gốc thay vì vá
Test trên vẫn đỏ sau khi code xong. Thay vì để agent thử lung tung:
/pk:debug test Loc_theo_khoang_ngay_tinh_ca_don_cuoi_ngay_ket_thuc vẫn đỏ
Agent tái hiện lỗi, đặt từng giả thuyết và kiểm từng cái:
Quan sát: query sinh ra CreatedAt <= '2026-11-30T00:00:00Z'
Giả thuyết: "to=2026-11-30" bị hiểu là 0 giờ ngày 30, nên mất cả ngày 30
Kiểm: đổi đơn mẫu sang 29/11 thì test xanh → giả thuyết đúng
Sửa gốc: CreatedAt < (to + 1 ngày, theo giờ VN, đổi sang UTC)
Đây đúng là lỗi "đơn cuối tháng biến mất" ở đầu bài, giờ được bắt bằng test chứ không phải bằng khách hàng.
Bước 6: test, chạy thật và báo thật
/pk:test
Agent tìm lệnh test thật của project (ở đây là dotnet test), chạy, rồi báo rõ cái gì qua, cái gì lỗi, cái gì không chạy được và vì sao. Nó không xoá hay nới lỏng test để có màu xanh, và không báo "xong" cho thứ chưa chạy.
Bước 7: review, soi diff trước khi mở PR
/pk:diff-security-inspector
Agent đọc diff thật, xếp lỗi theo mức độ, mỗi lỗi kèm file, cách gây ra và hậu quả:
[Cao] OrdersController.cs:48
Gây ra: gọi /orders?from=2000-01-01&to=2099-12-31 với tài khoản admin
Hậu quả: query quét cả bảng orders, khoảng 2 triệu dòng
Sửa: kiểm khoảng ngày tối đa 366 ngày ở controller, trả 400 kèm ProblemDetails
Nếu không tìm thấy lỗi, nó nói rõ là không thấy và giới hạn của lượt review, chứ không khẳng định "an toàn tuyệt đối".
Bước 8: handoff, bàn giao cho phiên sau
Hết ngày, việc còn dở (chưa thêm index cho CreatedAt):
/pk:session-handoff-contract --include-status
Agent viết một file Markdown để phiên sau, hoặc một agent khác, đọc vào là làm tiếp được: mục tiêu, các quyết định đã chốt (tính cả ngày cuối, giờ Việt Nam, tối đa 366 ngày), kết quả kiểm chứng, việc đang vướng, và bước tiếp theo an toàn. Thông tin nhạy cảm được lược bỏ khỏi file.
Ngoài 8 bước: các usecase khác
| Tình huống | Gõ | Bạn nhận được |
|---|---|---|
| Sắp làm một thay đổi lớn, chưa chắc hướng | /pk:predict-architecture-debate tách phần gửi email thành service riêng |
5 vai (Architect, Security, Performance, UX, Devil's Advocate) phân tích độc lập rồi tranh luận, kết luận GO, CAUTION hoặc STOP |
| Có một GitHub issue, muốn đi tới PR | /pk:autonomous-issue-to-pr <link issue> |
Chuỗi tạo worktree, plan, code, review, mở PR. Không bỏ qua bước duyệt, test hay quy tắc bảo vệ nhánh |
| Cần soát bảo mật cả module | /pk:stride-security-audit |
Soát theo STRIDE và OWASP từ góc nhìn nhiều kiểu kẻ tấn công |
| Phiên làm việc dài, AI bắt đầu "quên" | /pk:context-engineering-rules |
Theo dõi mức dùng context, gợi ý cách giảm token |
| Có một quy trình riêng hay lặp lại | /pk:skill-builder-studio |
Viết skill riêng có mô tả kích hoạt đúng lúc, kiểm bằng tình huống thật |
| Không biết nên dùng skill nào | /pk:primekit-router kèm mô tả việc |
Chọn chuỗi skill ngắn nhất đủ dùng, bỏ qua thủ tục với việc đơn giản |
Ví dụ với predict-architecture-debate, câu hỏi "có nên tách gửi email thành service riêng" sẽ được nhìn từ năm phía. Performance hỏi về độ trễ và hàng đợi. Security hỏi ai được gọi service mới. Devil's Advocate hỏi thẳng "sao không giữ nguyên và chỉ đưa việc gửi vào background job". Bạn có câu trả lời trước khi viết dòng code nào.
Cài, cập nhật, gỡ mà không sợ mất file
Bộ kit ghi lại vân tay (SHA256) của mọi file nó cài vào .primekit/manifest.json. Nhờ đó:
| Lệnh | Làm gì |
|---|---|
pk doctor |
Kiểm file có bị đổi không, skill có hợp lệ với từng công cụ không |
pk update |
Cập nhật lên bản mới, giữ nguyên file bạn đã tự sửa và báo lại |
pk uninstall |
Chỉ gỡ đúng file PrimeKit đã cài và còn nguyên vẹn, không đụng file của bạn |
pk import <skill> |
Đưa skill bạn tự viết vào mọi thư mục skill đã cài |
Gõ được pk sau khi cài CLI toàn cục bằng npm install -g @lovehlmmm/primekit, hoặc dùng npx @lovehlmmm/primekit <lệnh>.
Khi nào không cần chạy đủ 8 bước
- Việc nhỏ đã rõ: sửa một dòng cấu hình, đổi tên một biến thì cứ làm, không cần explore hay plan. Chính các skill cũng ghi rõ điều này, và
primekit-routerbỏ qua thủ tục với việc đơn giản. - Yêu cầu đã đủ rõ:
clarifykhông bắt bạn trả lời một bảng câu hỏi khi chẳng có gì mơ hồ. - Công cụ không hỗ trợ chạy nhiều agent độc lập: vài chế độ nâng cao (như
--ultra) sẽ báo thiếu khả năng thay vì giả vờ chạy. Các bước thường vẫn chạy tuần tự được trong một agent. - Skill không thay được phán đoán của bạn: chốt "tính cả ngày cuối" hay "giờ Việt Nam" vẫn là quyết định của người hiểu nghiệp vụ, skill chỉ giúp hỏi đúng lúc.
Thử ngay: chạy npx @lovehlmmm/primekit init trong project bạn đang làm, chọn ticket tiếp theo trong backlog, và cho nó đi qua ít nhất ba bước /pk:explore, /pk:clarify, /pk:diff-security-inspector. Để ý xem câu hỏi ở bước clarify có trúng chỗ bạn định đoán không. Dùng thử thấy skill nào hay, skill nào chưa ổn, comment cho mình biết nhé, mình là người làm bộ kit này nên sẽ đọc và sửa.
Tài liệu để đọc thêm:
- Trang chủ và quy trình 8 bước: primekit.nguyenanh98.com
- Danh sách đầy đủ 148 skill: primekit.nguyenanh98.com/skills
- Gói trên npm: @lovehlmmm/primekit
Series khác của mình
- Dùng AI hiệu quả trong công việc: kinh nghiệm thực chiến của dev: viết prompt đủ ngữ cảnh, bắt AI bịa API, giao việc cho agent, review code AI viết, debug, đọc codebase lạ, đóng gói quy trình thành skill.
- Code của người khác là AI slop, code của tôi thì không: Harness Engineering, MCP vs UTCP, All Code Is Slop, pstack, TokenEconomizer.
- Backend .NET thực chiến: những case hay gặp trên production: async/await làm treo API, HttpClient hết socket, EF Core kéo cả bảng, idempotency, outbox, caching, bảo mật API.
All rights reserved