Chuẩn Bị Trước Khi Cài AkiDevRule

Yêu cầu duy nhất bắt buộc là Python 3.7+ — installer, hook, và mọi script skill đều viết bằng Python, không dùng rsync/find/awk. Trên macOS và Linux còn cần git nếu bạn muốn dùng cách clone-and-run thay vì lệnh curl một dòng. install.sh tự chọn interpreter Python mới nhất có sẵn trên PATH, nên máy có python3 phiên bản cũ vẫn cài được nếu có bất kỳ Python ≥3.7 nào khác.

Cài Trên macOS Và Linux

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

Đây là cách nhanh nhất, không cần clone repo trước. Nếu bạn muốn đọc trước script (đúng tinh thần "inspectable before running" mà dự án theo đuổi), clone repo về rồi chạy bản local:

git clone https://github.com/lacvietanh/akidevrule.git
cd akidevrule
bash install.sh

Cài Trên Windows

Windows không dùng lệnh curl một dòng — clone repo rồi chạy trực tiếp installer Python (đúng triết lý "inspectable" của dự án, không có bước tải-và-chạy mù):

git clone https://github.com/lacvietanh/akidevrule.git
cd akidevrule
.\install.ps1
# hoặc: py -3 install.py

Windows không cần WSL, Git Bash hay shell POSIX nào — installer, hook và mọi script skill hỗ trợ đều là Python thuần, đã được kiểm chứng chạy trên windows-latest trong CI của dự án.

Installer Làm Gì Trên Máy Bạn?

  • Đồng bộ toàn bộ payload/* (rule corpus) vào ~/.aki/akidevrule/, tự xoá file cũ bị đổi tên, không đụng gì khác trong thư mục đó.
  • Đồng bộ 10 skill vào ~/.claude/skills/ — và song song vào ~/.gemini/config/skills/ (Antigravity), ~/.agents/skills/ (Codex CLI), ~/.kiro/skills/ (Kiro CLI), ~/.grok/skills/ (Grok CLI) nếu các CLI đó có mặt trên máy. Đồng bộ theo tên từng thư mục skill, không xoá skill khác bạn đã có sẵn.
  • Copy 5 file agent vào ~/.claude/agents/ từng file một, giữ nguyên agent tự viết của bạn.
  • Ghi đè ~/.claude/CLAUDE.md bằng bản đóng gói (backup có timestamp trước khi ghi), thêm dòng @~/.claude/CLAUDE.local.md import và đường dẫn source-repo của máy bạn.
  • Tạo ~/.claude/CLAUDE.local.md chỉ khi chưa tồn tại — không bao giờ ghi đè lần sau, để bạn có chỗ lưu rule riêng theo máy sống sót qua mọi lần cài lại.
  • Cập nhật ~/.claude/settings.json (backup trước khi sửa): cấp quyền đọc ~/.aki/akidevrule/**, bật skillOverrides.akirule = "on", đăng ký hook kiểm tra bản mới lúc khởi động phiên.

Không có bước nào yêu cầu sudo hay quyền admin — toàn bộ cài đặt nằm trong thư mục người dùng.

Cập Nhật AkiDevRule

Một hook SessionStart tự kiểm tra CHANGELOG.md cài đặt so với bản trên GitHub (tối đa 1 lần/24h, fail-silent, không bao giờ chặn phiên làm việc). Khi có bản mới, nó chỉ in ra lệnh cập nhật chứ không tự tải hay tự cài:

git pull && ./install.sh   # Unix
git pull; py -3 install.py   # Windows

Gỡ Cài Đặt

Xoá thư mục cài đặt và các skill/agent đã đồng bộ:

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

Sau đó xoá thủ công khối cấu hình AkiDevRule khỏi ~/.claude/CLAUDE.md và các mục liên quan trong settings.json nếu muốn dọn sạch hoàn toàn. Tìm hiểu AkiDevRule làm được gì trước khi cài tại bài AkiDevRule Là Gì?, hoặc đọc sâu cơ chế nạp rule tại Rule Corpus Và Skill Của AkiDevRule Hoạt Động Ra Sao.