AkiDevRule 3.x: cài bằng npx, hook chặn bước bị bỏ qua

AkiDevRule đi từ 3.0.0 (13/09/2026) đến 3.7.0 (08/10/2026) với một hướng nhất quán: biến việc đọc rule từ lời nhắc thành cơ chế có thể kiểm. Cài đặt gọn lại thành một lệnh npx, còn các lỗi agent bỏ qua bước bắt buộc được chặn bằng hook thay vì nhắc bằng lời.

Cài và cập nhật AkiDevRule thế nào từ 3.0?

Từ 3.0.0, đường cài chính là npx @akinet/akidevrule@latest, không cần clone, và chạy lại chính lệnh đó để cập nhật. Trình cài viết lại bằng Node.js thuần nên không còn cần Python, và bản mới sao ra đúng 121 file như trình cài cũ. Từ 3.2.0 trình cài tự tìm mọi thư mục cấu hình Claude (~/.claude*), từ 3.7.0 thêm khối rule thường trực cho Codex CLI.

Hook chặn sửa file khi chưa đọc rule hoạt động ra sao?

Hook aki-route-guard (3.6.0) từ chối lần Edit hoặc Write đầu tiên của mỗi loại file trong một phiên cho tới khi các file rule tương ứng đã được đọc, và thông báo từ chối nêu tên file cần đọc. Lý do: đo trên transcript thật cho thấy biên nhận [RULES] có mặt nhưng bước đọc rule thứ hai vẫn bị bỏ qua. Bản 3.7.0 chỉ tính lần đọc sau lần nén ngữ cảnh gần nhất, vì rule đã đọc trước khi nén không còn nằm trong ngữ cảnh của model.

Điều gì thay đổi ở 3.7.0 cho Claude Opus 5.5 và Sonnet 5.5?

• ◆agent.B7 quy định rule của bạn thắng chỉ dẫn của harness, kèm thẻ phạt [SKIP] cho bước bắt buộc bị rút gọn.
• ◆Hook aki-compact-reread báo một lần sau mỗi lần nén rằng các rule đã đọc không còn trong ngữ cảnh.
• ◆RULE-test.md và test_lint.py quy định viết ít test nhất có thể và cấm test ghi đè dữ liệu thật, sau một bộ 51 test xanh vẫn ghi đè thư mục dữ liệu ứng dụng thật.
• ◆Mỗi mục báo cáo còn dở mang một mã ngắn ổn định, và agent phải dọn worktree, thư mục build do chính nó tạo.

Các phiên bản 3.1 đến 3.6 thêm gì đáng chú ý?

• ◆3.1.0: /akiship kích hoạt bằng lệnh phát hành tường minh, và deep-think chạy tự động ở các điểm kích hoạt đã định.
• ◆3.3.0: /akiship bắt buộc nạp rule, ghi biên nhận cho từng bước và có học thuyết migration cùng kiểm chứng sau deploy.
• ◆3.5.0: cấm agent tự ý git stash, reset --hard hay clean, và thêm tài liệu sự thật docs/ref/fact-* mang nguồn kiểm chứng.
• ◆3.6.0: luật pattern.A9 yêu cầu bản nháp tách khỏi bản ghi, và template CLAUDE.md rút xuống hai dòng import.

Nên bắt đầu từ đâu?

Chạy npx @akinet/akidevrule@latest trên máy đang dùng Claude Code, rồi mở phiên mới: bộ rule hành vi và router đã nằm sẵn trong ngữ cảnh, phần còn lại được nạp khi tác vụ khớp. Gói chỉ cài file Markdown, skill và hook vào thư mục cấu hình của bạn, không chạy dịch vụ nền. Bài Rule cho AI coding agent giải thích cách các lớp rule ghép với nhau.