AkiDev

Cài AkiDevRule 3.8 cho Claude Code, Codex, Gemini, Cursor, Kiro, Grok và OpenCode

akidevruleclaude-codeai-agentrule

AI rule (airule) là gì?

AI rule là một tệp văn bản, thường là Markdown, mà agent lập trình đọc trước khi làm việc để biết điều gì nó phải làm và điều gì không được làm. Claude Code đọc CLAUDE.md, Codex đọc AGENTS.md, Gemini đọc GEMINI.md: mỗi công cụ một tên tệp, cùng một mục đích. Viết tay cho từng dự án và từng công cụ thì nhanh chóng lệch nhau.

AkiDevRule gom việc đó về một nguồn. Đây là bộ baseline mã nguồn mở (giấy phép MIT) gồm kho rule tự nạp đúng lúc, mười một skill và năm agent definition, cài một lần cho cả 7 công cụ. Mã nguồn nằm ở lacvietanh/akidevrule trên GitHub, gói npm là @akinet/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.

Cài AkiDevRule 3.8 bằng lệnh nào?

Chạy một lệnh trong terminal, cần Node.js 18 trở lên và không cần gì khác:

npx @akinet/akidevrule@latest

Lệnh chạy giống nhau trên macOS, Linux và Windows. npx luôn lấy bản mới nhất đã phát hành, nên chạy lại chính lệnh này là cách cập nhật. Python chỉ cần khi bạn chạy các script phụ của skill akiflow, không cần để cài hay cập nhật.

Ngại chạy gói npm thì có hai đường khác: curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash, hoặc trên Windows clone repo rồi chạy .\install.ps1. Launcher cố tình đơn giản, bạn nên đọc nó trước khi chạy.

Cài xong thì mỗi công cụ nhận được gì?

Một kho rule chung nằm ở ~/.aki/akidevrule/, rồi mỗi công cụ nhận phần nó đọc được:

Công cụ Nhận được
Claude Code skill vào ~/.claude/skills/, năm agent vào ~/.claude/agents/, CLAUDE.md đóng gói, ba hook, quyền chạy script trong settings.json; mọi thư mục ~/.claude* được phát hiện đều được cài
Gemini / Antigravity ~/.gemini/GEMINI.md, mỗi rule một tệp trong ~/.gemini/config/rules/, skill trong ~/.gemini/config/skills/
Codex skill vào ~/.agents/skills/; nếu thư mục ~/.codex có sẵn thì thêm một khối quản lý trong ~/.codex/AGENTS.md
Cursor skill dùng chung ở ~/.agents/skills/, quyền chạy script trong ~/.cursor/cli-config.json
Kiro skill vào ~/.kiro/skills/, quyền chạy script trong ~/.kiro/settings/permissions.yaml
Grok chỉ skill, vào ~/.grok/skills/
OpenCode quyền chạy script trong ~/.config/opencode/opencode.json

Trình cài chỉ chạm vào những tên tệp nó tự quản lý. Skill, agent hay rule bạn có sẵn không bị xóa. Riêng Claude Code có hai tệp thường trú nạp mọi phiên: RULE-agent-behavior.md và router akirule. Các rule còn lại (code, docs, SEO, release và nhiều mục khác) chỉ được đọc khi nghĩa của tác vụ khớp. Hook aki-route-guard từ chối lần sửa tệp đầu tiên của mỗi loại cho tới khi rule tương ứng đã được đọc trọn.

Làm sao biết đã cài đúng?

Chạy npx @akinet/akidevrule@latest --check: lệnh in ra bản đã cài và bản mới nhất mà không đổi gì. Kết quả là một trong năm trạng thái: chưa cài, đã mới nhất, có bản mới, vượt bản công bố hoặc chưa xác định được do lỗi mạng. Trong Claude Code, câu trả lời đầu tiên của agent mở bằng một dòng [RULES] liệt kê rule đang nằm trong ngữ cảnh. Không thấy dòng đó, rule chưa tới nơi.

Muốn một rule được nạp chắc chắn, hãy gọi tên tệp rule trong yêu cầu. Việc đọc rule theo tuyến vẫn là một bước do model tự quyết, trừ khi hook chặn lần sửa đầu tiên.

AkiDevRule 3.8 có gì mới?

Sáu thay đổi, xếp theo thứ tự bạn sẽ gặp chúng khi làm việc:

  1. Hỏi chỉ được trả lời, không bị sửa file. Một câu hỏi nhận câu trả lời và không đổi file nào. Một mệnh lệnh được chạy đến cùng mà không hỏi lại, và lệnh đầu tiên làm thay đổi trạng thái phải chỉ ra lời nào của bạn đã ra lệnh.
  2. Yêu cầu là toàn bộ phạm vi. Pull request, push, deploy hay tag mà bạn không yêu cầu sẽ không được làm chỉ vì đó là bước quen thuộc.
  3. Việc còn mở gắn mã Q, T, N. Q là việc chờ bạn trả lời, im lặng thì dừng. T là việc agent tự quyết trong phạm vi lệnh, im lặng thì chạy tiếp. N là ghi chú, im lặng thì không đổi gì. Hết Q là bạn đọc xong.
  4. Bớt tệp rác. Tệp tạm chỉ nằm trong thư mục tạm riêng của phiên làm việc hoặc không được tạo. Mỗi trạng thái thay đổi chỉ chạy kiểm tra một lần, vì 20% lần chạy kiểm tra trong 516 phiên Claude Code của tác giả là chạy lại khi chưa sửa gì.
  5. Rule phải đọc trọn mới tính. Đọc một phần tệp rule không còn được tính, hook mở rộng thành đọc cả tệp, và lần đọc trong Cursor giờ cũng được đếm.
  6. Trình cài gọn hơn. Không còn tệp *.akidevrule-backup-* bỏ lại sau mỗi lần chạy. Cấu hình rtk là tùy chọn, mặc định không, thêm cờ --rtk để đồng ý mà không bị hỏi. Bảng ánh xạ đường dẫn sang rule nằm trong một tệp route-map.json.

Chi tiết từng thay đổi có trong Release 3.8.0 trên GitHub.

Cập nhật và gỡ AkiDevRule như thế nào?

Cập nhật bằng cách chạy lại npx @akinet/akidevrule@latest. Trong Claude Code, hook SessionStart chỉ báo khi có bản mới (tối đa một lần mỗi 24 giờ), không tự cài gì.

Gỡ thì xóa theo từng thư mục. Phần chính:

rm -rf ~/.aki/akidevrule
rm -rf ~/.claude/skills/{akirule,akiflow,akithink,akihtmlreport,akihelp,akigitcommit,akilint,akiopen,akiship,aki-article-writer,akidevsync-notes}
rm -f  ~/.claude/agents/aki-{hands,judge,conduct,challenger,maker}.md

Danh sách đầy đủ, gồm skill của Codex, Kiro, Grok, các hook, khối trong ~/.codex/AGENTS.md và cấu hình rtk, nằm ở mục Uninstall của README. Sau khi xóa, bạn bỏ khối AkiDevRule trong ~/.claude/CLAUDE.md và các mục của nó trong ~/.claude/settings.json nếu muốn.

Báo lỗi hoặc góp ý ở đâu?

Mở issue trên kho GitHub. AkiDevRule nằm trong nhóm công cụ developer của AkiDev, các dự án khác xem ở trang hệ sinh thái.