AkiDevRule Là Gì?

AkiDevRule là bộ quy tắc (rule) cộng với các skill dùng chung, giúp AI coding agent như Claude Code làm đúng việc bạn giao và báo cáo gọn. Một lệnh cài đặt đưa cả bộ vào máy cho 7 công cụ: Claude Code, Codex, Gemini/Antigravity, Cursor, Kiro, Grok và OpenCode. Dự án mã nguồn mở, giấy phép MIT, do Lạc Việt Anh duy trì trên GitHub.

AkiDevRule chạy trong terminal, không phải web app: không giao diện, không tài khoản, không thu thập dữ liệu. Trang tổng quan của dự án nằm ở trang dự án AkiDevRule.

AkiDevRule 3.8 với sáu thay đổi: hỏi chỉ trả lời, đúng phạm vi, mục mở Q/T/N, bớt rác, đọc trọn rule, trình cài gọn hơn.
Hỏi thì trả lời, ra lệnh thì làm xong, báo cáo đọc lướt được: những gì mới trong AkiDevRule 3.8.

AkiDevRule Giúp Gì Cho Người Mới Dùng Claude Code?

AkiDevRule cho người mới một bộ quy tắc làm việc đã viết sẵn, thay vì tự soạn file CLAUDE.md từ đầu. Mặc định agent hay làm quá tay: sửa thứ bạn chỉ hỏi, tự thêm bước bạn không nhờ, báo cáo dài khó đọc. Bộ rule dặn sẵn agent tránh những điều đó, và chia thành nhiều file nhỏ để agent chỉ đọc phần cần dùng, bạn khỏi chép đi chép lại cho từng công cụ.

Vì Sao AkiDevRule Ra Đời?

Dùng nhiều AI agent cùng lúc thì rule dễ bị viết trùng: mỗi công cụ một bản, sửa chỗ này quên chỗ kia. AkiDevRule viết rule một lần trong một repo Git, rồi trình cài đặt đưa đúng dạng cho từng công cụ. Repo là nguồn duy nhất; bản trên máy bạn chỉ là bản sao.

Bản 3.8 Thay Đổi Gì Cho Người Dùng?

Bản 3.8.0 (20/10/2026) sửa ba thói quen khiến agent khó chịu nhất, theo Release 3.8.0:

  • Hỏi thì trả lời, ra lệnh thì làm. Câu hỏi, lời nói lửng hay lời góp ý về việc chưa ai giao chỉ nhận câu trả lời, không file nào bị sửa. Muốn agent làm, bạn dùng động từ hành động ("sửa X đi"). Một khi đã ra lệnh, agent làm đến cùng, không hỏi lại từng bước. Trước lần ghi đầu tiên, agent phải nêu được câu nào của bạn là lệnh.
  • Yêu cầu là toàn bộ phạm vi. Agent không tự mở pull request, push, deploy hay gắn tag chỉ vì đó là bước thường lệ; làm xong việc được giao thì dừng và báo cáo.
  • Mục còn mở được đánh mã Q, T, N. Q là việc bạn phải trả lời thì mới đi tiếp. T là điều agent tự quyết trong phạm vi lệnh, bạn im lặng thì nó cứ làm. N là ghi chú, bạn im lặng cũng không gì đổi. Hết Q thì bạn đọc xong.

Ngoài ra bản 3.8 bớt file rác (file tạm đi vào thư mục nháp hoặc không tạo), mỗi trạng thái code chỉ chạy kiểm tra một lần, rule chỉ được tính là đã đọc khi đọc trọn file, và trình cài đặt không còn để lại file sao lưu thừa.

AkiDevRule Cài Những Gì?

  • 13 file RULE và 7 file METHOD: RULE là ràng buộc hành vi (hành vi agent, code, cấu trúc, tài liệu, nội dung, SEO, phát hành, test, DB...), METHOD là khung phân tích (suy nghĩ sâu, kiểm tra luồng, tâm lý UX...). Chỉ file hành vi cốt lõi và bộ định tuyến được nạp mỗi phiên; các file còn lại được nạp khi việc bạn làm đụng tới lĩnh vực của chúng.
  • 11 skill theo chuẩn mở SKILL.md: akirule, akiflow, akithink, akihtmlreport, akihelp, akigitcommit, akilint, akiopen, akiship, aki-article-writer, akidevsync-notes. Mỗi skill là một lệnh gọi cho một việc, ví dụ /akigitcommit gom thay đổi thành các commit gọn.
  • 5 agent định nghĩa sẵn (chỉ Claude Code): một agent chỉ tìm dữ kiện, một agent chấm theo đúng một tiêu chuẩn, một agent kiểm tra rule có được tuân thủ, một agent phản biện, và aki-maker là agent duy nhất được ghi file.

AkiDevRule Có Phải Công Cụ Tự Cập Nhật Không?

Không. Nó không chạy nền và không tự tải gì. Muốn lên bản mới, bạn chạy lại cùng một lệnh cài; thêm --check để chỉ xem bản đang cài so với bản mới nhất mà không đổi gì.

Cài AkiDevRule Thế Nào?

npx @akinet/akidevrule@latest

Cần Node.js 18 trở lên, không cần gì khác và không cần quyền sudo. Hướng dẫn từng bước cho macOS, Linux, Windows ở bài Cài AkiDevRule cho Claude Code; cơ chế nạp rule ở bài Rule corpus và skill của AkiDevRule hoạt động ra sao. Mã nguồn và CHANGELOG ở GitHub, gói cài ở npm.