Cài AkiDevRule Cần Chuẩn Bị Gì?

Bạn chỉ cần Node.js 18 trở lên, vì trình cài đặt là một chương trình Node chạy giống nhau trên macOS, Linux và Windows, không cần WSL hay Git Bash. Python 3.7+ chỉ cần khi bạn dùng các script phụ của skill akiflow, không cần để cài. Tổng quan sản phẩm xem ở bài AkiDevRule là gì và 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.

Cài AkiDevRule Bằng Một Lệnh Thế Nào?

npx @akinet/akidevrule@latest

npx luôn tải bản mới nhất đã phát hành (hiện là 3.8.0, Release 3.8.0), nên cài lần đầu và cập nhật là cùng một lệnh. Nếu muốn đọc trước khi chạy, dùng cách khác:

curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash

Trên Windows không dùng npm, clone repo rồi chạy trực tiếp:

git clone https://github.com/lacvietanh/akidevrule.git
cd akidevrule
.\install.ps1
# hoặc: node install.mjs

Trình Cài Đặt Làm Gì Trên Máy Bạn?

  • Chép toàn bộ rule vào ~/.aki/akidevrule/, xóa các file cũ đã bị đổi tên, không đụng gì khác trong thư mục đó.
  • Chép 11 skill vào thư mục skill của từng công cụ có trên máy: ~/.claude/skills/ (Claude Code), ~/.gemini/config/skills/ (Antigravity), ~/.agents/skills/ (Codex, Cursor), ~/.kiro/skills/ (Kiro), ~/.grok/skills/ (Grok). Skill khác bạn đã có được giữ nguyên.
  • Chép 5 file agent vào ~/.claude/agents/ từng file một, agent tự viết của bạn không bị xóa.
  • Thay ~/.claude/CLAUDE.md bằng bản đóng gói và tạo ~/.claude/CLAUDE.local.md chỉ khi chưa có, để rule riêng của máy bạn sống sót qua mọi lần cài lại.
  • Cập nhật ~/.claude/settings.json (cấp quyền đọc rule, đăng ký các hook kiểm tra bản mới và kiểm tra đã đọc rule trước khi sửa file).

Từ bản 3.8, trình cài đặt không còn để lại các file sao lưu *.akidevrule-backup-* sau khi chạy xong. Nếu máy bạn có công cụ nén output rtk, trình cài đặt chỉ hỏi một lần có ghi cấu hình an toàn cho rtk không, mặc định là không (thêm --rtk nếu muốn đồng ý sẵn). Không bước nào cần sudo.

Làm Sao Biết AkiDevRule Đã Cài Xong?

Chạy npx @akinet/akidevrule@latest --check: lệnh này in bản đang cài so với bản mới nhất và không đổi gì. Rồi mở Claude Code và xem ~/.claude/CLAUDE.md có dòng @-import trỏ tới ~/.aki/akidevrule/. Trong phiên làm việc, câu trả lời đầu tiên của agent sẽ mở bằng một dòng [RULES] cho biết rule nào đang được nạp.

Cập Nhật AkiDevRule Thế Nào?

Chạy lại npx @akinet/akidevrule@latest. Một hook ở đầu phiên chỉ thông báo khi có bản mới (tối đa một lần mỗi 24 giờ), không tự tải hay tự cài.

Gỡ AkiDevRule Thế Nào?

Xóa thư mục rule và các skill, agent, hook đã chép:

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
rm -f  ~/.claude/hooks/aki-update-check.mjs ~/.claude/hooks/aki_version_check.mjs ~/.claude/hooks/aki-route-guard.mjs ~/.claude/hooks/aki-compact-reread.mjs

Sau đó xóa khối AkiDevRule trong ~/.claude/CLAUDE.md và các mục liên quan trong settings.json nếu muốn dọn sạch. Danh sách đầy đủ cho từng công cụ nằm trong README trên GitHub; gói cài ở npm. Muốn hiểu rule được nạp thế nào, đọc Rule corpus và skill của AkiDevRule hoạt động ra sao.