0

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-router bỏ qua thủ tục với việc đơn giản.
  • Yêu cầu đã đủ rõ: clarify khô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:


Series khác của mình


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí