Ngày tạo: Cập nhật:
AkiClaudeDoc — Claude Code baseline

AkiClaudeDoc

Mã nguồn mở

Một lệnh biến môi trường Claude Code mới tinh thành baseline làm việc đầy đủ của Aki.

github.com/lacvietanh/AkiClaudeDoc  ·  Nhánh master · Claude Code

AkiClaudeDoc là gói baseline mã nguồn mở (giấy phép MIT, công khai từ 22/05/2026) cho Claude Code. Một lệnh cài duy nhất biến môi trường Claude Code mới thành baseline làm việc đầy đủ của Aki: một kho rule chung tự nạp đúng thời điểm, cùng một bộ skill nhỏ gọn — mỗi skill làm một việc thật sắc. Kho rule theo quy ước đặt tên chặt (RULE-* là ràng buộc, METHOD-* là khung tư duy) và được skill akirule định tuyến theo ba tầng. Repo GitHub là nguồn chân lý duy nhất. Nó không phải auto-updater, daemon, package manager hay control plane.

Cài đặt — một lệnh duy nhất (nhánh master)

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

Script cố tình đơn giản — nên đọc trước khi chạy.

  • Cài một lệnh curl (nhánh master), hoặc bash install.sh từ bản checkout local
  • Kho rule tự định tuyến: 10 file RULE-* (ràng buộc) + 2 METHOD-* (khung phân tích) + index.md
  • Bộ định tuyến akirule ba tầng, độ nhạy cố tình cao — thà nạp thừa còn hơn sai hành vi
  • Năm skill, mỗi skill làm sắc một việc: akirule, akithink, akihtmlreport, akihelp, akigitcommit
  • Thông báo cập nhật chỉ báo — không tự tải, không tự cài, không daemon
  • Mã nguồn mở (giấy phép MIT) từ 22/05/2026 — repo GitHub là nguồn chân lý
  • Thuộc hệ sinh thái Aki — hơn 5.500 người dùng, một tài khoản dùng chung
GitHub

Điểm cốt lõi

Cài một lệnh, baseline đầy đủ

Một lệnh curl biến môi trường Claude Code mới thành baseline làm việc đầy đủ của Aki. Cũng có thể chạy bash install.sh từ bản checkout local. Script cố tình đơn giản để bạn tự kiểm tra trước khi chạy.

Kho rule tự định tuyến theo tên

Quy ước đặt tên chặt: RULE-*.md là ràng buộc (điều Claude phải/không được làm — behavior, coding, docs, content, stack, SEO, release, DB design); METHOD-*.md là khung tư duy phân tích, nặng, chỉ nạp khi tác vụ thật sự cần; index.md giữ manifest, thứ tự ưu tiên và chính sách gắn dự án.

Bộ định tuyến akirule ba tầng

akirule định tuyến với độ nhạy cố tình cao (thà nạp thừa): Tầng 1 core nạp mọi hội thoại (index.md, RULE-agent-behavior, RULE-coding) qua cú pháp embed @path; Tầng 2 contextual đọc khi khớp tín hiệu; Tầng 3 là các METHOD phân tích. Không có "harness magic" — Tầng 2–3 chỉ là chỉ dẫn bảo Claude Read file từ ~/.aki/claudedoc/ khi tín hiệu khớp.

Năm skill, mỗi skill làm sắc một việc

akirule (bộ định tuyến rule tự động), akithink (phiên tư duy sâu 5 pha, kết thúc bằng decision record trong docs/), akihtmlreport (đúc phân tích dày trong hội thoại thành một REPORT.html tự chứa), akihelp (giới thiệu hệ thống Aki đã cài, dựng lúc chạy nên không bao giờ lỗi thời), akigitcommit (biến working tree lộn xộn thành vài commit Conventional gọn gàng, stage theo path, không bao giờ git add -A hay tự push).

Một bộ não, hai chế độ tư duy

METHOD-deep-think.md là một bộ não phân tích duy nhất (đào mục tiêu, first principles, phê phán bắt buộc, lăng kính techbiz có điều kiện) dùng hai cách: Passive — akirule tự nạp inline khi tác vụ thường chạm tín hiệu ("có nên…", "có đáng…"), áp dụng ngắn, tối đa một câu hỏi làm rõ; Active — chạy /akithink để đi qua đúng METHOD đó theo protocol 5 pha ở độ sâu tối đa.

Thông báo cập nhật — chỉ báo, không tự cài

Một hook SessionStart so CHANGELOG.md đã cài với bản public trên repo (tối đa 1 lần/24h, thất bại thì im lặng, không chặn). Khi bản remote mới hơn, nó chỉ in phần thay đổi và lệnh cập nhật thủ công (git pull && bash install.sh). Nó không bao giờ tự tải hay tự cài bất cứ thứ gì.

Bộ định tuyến akirule — ba tầng

Tầng 1 — Core

Nạp mọi hội thoại qua embed @path: index.md, RULE-agent-behavior.md, RULE-coding.md.

Tầng 2 — Contextual

Đọc khi khớp tín hiệu: design-core, docs, content-write, stack-akiNuxtCf, ui-pattern, seo, release, db-design.

Tầng 3 — Methods

Khung phân tích, chỉ nạp khi tác vụ thật sự cần: METHOD-flow-audit, METHOD-deep-think.

Năm skill, mỗi skill làm sắc một việc

akirule

tự động

Bộ định tuyến rule thông minh, chạy mọi hội thoại; ẩn khỏi menu /.

akithink

/akithink

Phiên tư duy sâu 5 pha, kết thúc bằng decision record trong docs/.

akihtmlreport

/akihtmlreport

Đúc phân tích dày trong hội thoại thành một REPORT.html tự chứa.

akihelp

/akihelp

Giới thiệu hệ thống Aki đã cài, dựng lúc chạy nên không bao giờ lỗi thời.

akigitcommit

/akigitcommit

Biến working tree lộn xộn thành vài commit Conventional gọn; stage theo path, không git add -A, không tự push.

Người phát triển

Lạc Việt Anh  —  người sáng lập hệ sinh thái Aki. AkiClaudeDoc đúc kết cách anh làm việc cùng Claude Code trên toàn hệ sinh thái thành một baseline dùng chung, và phát hành mã nguồn mở theo giấy phép MIT để cộng đồng có thể tham khảo, tái sử dụng.

AkiClaudeDoc thuộc lớp công cụ dev của hệ sinh thái, gắn với AkiDEV (dev.akitao.com) — nơi đặt trang docs và bản wrapper cài đặt. Xem thêm các dự án liên quan: AkiDEV và Aki Dev Sync.

Câu hỏi thường gặp

AkiClaudeDoc là gì?
AkiClaudeDoc là gói baseline mã nguồn mở cho Claude Code. Chỉ một lệnh cài, nó biến môi trường Claude Code mới tinh thành baseline làm việc đầy đủ của Aki: một kho rule chung tự nạp đúng thời điểm, cùng một bộ nhỏ các skill, mỗi skill làm sắc một việc.
Cài AkiClaudeDoc như thế nào?
Chạy: curl -fsSL https://raw.githubusercontent.com/lacvietanh/AkiClaudeDoc/master/install.sh | bash (lưu ý nhánh là master, không phải main). Ngoài ra có thể chạy bash install.sh từ bản checkout local. Script cố tình đơn giản — nên kiểm tra trước khi chạy.
AkiClaudeDoc cài những gì và cài vào đâu?
payload/* được đồng bộ vào ~/.aki/claudedoc/ (loại trừ ref-ECC/), gồm index.md, mười file RULE-* và hai file METHOD-*. Các skill trong claude/skills/* được chép vào ~/.claude/skills/. Trình cài cũng thay ~/.claude/CLAUDE.md bằng bản đóng gói (sao lưu trước), tạo ~/.claude/CLAUDE.local.md chỉ khi chưa có (không bao giờ ghi đè sau đó — nơi để rule riêng từng máy), cập nhật ~/.claude/settings.json và cài hook aki-update-check.py.
akirule quyết định nạp rule nào, khi nào, ra sao?
Ba tầng với độ nhạy cố tình cao (thà nạp thừa vài token còn hơn sai hành vi). Tầng 1 core nạp mọi hội thoại: index.md, RULE-agent-behavior.md, RULE-coding.md. Tầng 2 contextual đọc khi khớp tín hiệu: design-core, docs, content-write, stack-akiNuxtCf, ui-pattern, seo, release, db-design. Tầng 3 là các METHOD phân tích (flow-audit, deep-think), chỉ nạp khi tác vụ thật sự cần phân tích.
Nó có tự động cập nhật máy tôi không?
Không. Nó chỉ báo, không tự cài. Một hook SessionStart so CHANGELOG đã cài với bản public (tối đa 1 lần/24h, thất bại thì im lặng, không chặn); khi có bản mới nó chỉ in phần thay đổi và lệnh cập nhật thủ công (git pull && bash install.sh). Repo Git là nguồn chân lý — không phải auto-updater, daemon hay package manager.
Gỡ AkiClaudeDoc thế nào?
Xóa: rm -rf ~/.aki/claudedoc; rm -rf ~/.claude/skills/{akirule,akithink,akihtmlreport,akihelp,akigitcommit}; rm -f ~/.claude/hooks/aki-update-check.py. Sau đó xóa khối AkiClaudeDoc trong ~/.claude/CLAUDE.md và các mục của nó (permission, skillOverrides, hook SessionStart) trong ~/.claude/settings.json nếu muốn.

Một lệnh. Cùng baseline. Repo Git là nguồn chân lý.

Xem trên GitHub
Xem tất cả dự án