Ra Mắt AkiDevRule và akiflow: Bộ Rule Và Hội Đồng AI Agent Cho Lập Trình

AkiDevRule là bộ rule mã nguồn mở (MIT) cho các AI coding agent như Claude Code và Antigravity, kèm mười skill, trong đó akiflow điều phối một hội đồng agent. Cả bộ nhắm vào ba lỗi cấu trúc của một agent làm việc một mình: tràn ngữ cảnh, sụp đổ vai trò và tự phê duyệt.

Model mạnh hơn hay prompt dài hơn không sửa được ba lỗi này, vì chúng đến từ cấu trúc: cửa sổ ngữ cảnh có giới hạn, và cùng một ngữ cảnh vừa tạo ra quyết định vừa chấm quyết định đó.

Vì sao một AI agent làm một mình thì hỏng?

[CAUTION] Tự phê duyệt (self-approval): ngữ cảnh đã tạo ra quyết định thì không thể phán xét quyết định đó một cách khách quan. Reviewer dùng chung ngữ cảnh với người viết sẽ thừa hưởng cả những giả định sai của họ.

AkiDevRule: một nguồn sự thật, mỗi quy tắc có địa chỉ

Bộ rule chia làm ba tầng. Tầng core được nạp vào mọi phiên qua @-import trong ~/.claude/CLAUDE.md: index.md, RULE-agent-behavior.md, RULE-coding.md, RULE-pattern-core.md và skill định tuyến akirule. Tầng contextual là các rule theo miền (RULE-docs.md, RULE-release.md, RULE-seo.md, RULE-ui-pattern.md...), chỉ được đọc khi tác vụ chạm đúng miền đó. Tầng analytical là các phương pháp tư duy và kiểm tra như METHOD-deep-think.md, METHOD-audit-flow.md, METHOD-ux-psych.md.

Mỗi quy tắc có địa chỉ dạng topic.A1. Ví dụ coding.B3 nói rằng một thay đổi cần thao tác lên hệ thống bên ngoài thì chưa xong khi mới viết xong file, còn agent.B5 bắt buộc mọi audit chỉ đọc. Agent dẫn quy tắc bằng địa chỉ thay vì diễn đạt lại theo ý mình.

akiflow điều phối hội đồng agent như thế nào?

Bạn gọi /akiflow <yêu cầu>, phiên làm việc trở thành "lead" điều phối. Lead chạy theo hai luật. R1 (Anchor): lời chủ dự án là bất biến và là phép thử cuối, lead không được diễn giải lại. R2 (Justification): mọi cơ chế, gồm ghế ngồi, bước kiểm và script, mặc định tắt và chỉ bật khi chính lượt chạy đó có lý do.

Trước khi mở phòng, lead ghim nguyên văn yêu cầu, tách thành các work item có chủ sở hữu, người phản biện và tiêu chí đóng, rồi kiểm cổng kích hoạt ba điều kiện: phân rã được thành ít nhất hai item, có nhiều chuẩn "đúng" khác nhau, và chi phí sai lớn hơn chi phí điều phối. Chi tiết ở bài cổng kích hoạt.

Năm định nghĩa agent cố định: aki-hands chỉ truy xuất và cấm phán xét; aki-judge phán xét theo đúng một chuẩn được nêu lúc gọi; aki-conduct kiểm tra quy trình, có dùng scythe.py; aki-challenger tấn công kết quả từ ngữ cảnh sạch; aki-maker là agent duy nhất được ghi file.

Các script gác cổng: council_open.py ghim nguyên văn yêu cầu và từ chối mở phòng nếu thiếu, còn --convene từ chối triệu tập khi chưa có item nào đủ owner, challenger và tiêu chí đóng; council_read.py cho định vị rồi chỉ đọc đúng đoạn cần; council_verify.py chặn đóng phiên khi thiếu receipt [RULES], thiếu tag FACT/CONSTRAINT/ASSUMPTION hoặc có yêu cầu không item nào bao phủ; council_cost.py cộng token đã dùng khi đóng phiên.

Áp dụng trong hệ sinh thái Aki

AkiDevRule là bộ rule chung của các dự án trong hệ sinh thái Aki, kể cả dự án Nuxt 4 và Cloudflare như akitao.com (qua RULE-stack-akiNuxtCf.md).

Đến bản 3.4.0 (26/09/2026), bộ có mười skill: akiflow, akiship, akirule, akithink, akilint, akigitcommit, akihelp, akihtmlreport, akidevsync-notes và aki-article-writer. /akiship gom nghi thức phát hành hằng ngày (lint, dọn theo phần diff, đồng bộ doc, commit theo nhóm, quyết định mint version hay để dành, tạo artifact) vào một lệnh, đi theo release.B7 và release.B8 thay vì lặp lại các quy tắc đó.

Cài đặt AkiDevRule và akiflow

Toàn bộ mã nguồn công khai theo giấy phép MIT trên GitHub (lacvietanh/akidevrule).