Cài đặt BA-kit
Cài đặt BA-kit trong 10 phút. Hướng dẫn cài cho cả 3 runtime: Claude Code, Codex, và Antigravity.
Cài đặt BA-kit
Hướng dẫn này giúp bạn cài BA-kit cho cả 3 runtime. Bạn chỉ cần chọn runtime mình đang dùng và làm theo. Mất khoảng 10 phút.
Nếu chưa từng cài tool dòng lệnh — đừng lo. Các bước bên dưới là copy-paste là chạy.
Trước khi bắt đầu
Bạn cần:
- Quyền truy cập vào private repo
bakit-org/bakit(xem Điều khoản) - Git đã cài trên máy
- Một trong 3 runtime: Claude Code, Codex, hoặc Antigravity
Nếu chưa có runtime, xem hướng dẫn chọn runtime trước.
Bước 1: Clone repo
git clone https://github.com/bakit-org/bakit.git
cd bakitBước 2: Cài đặt theo runtime
Claude Code
./install.shScript sẽ copy skills, rules, templates vào ~/.claude/.
Kiểm tra: Mở Claude Code, gõ /ba-start. Nếu thấy menu hiện ra là thành công.
Codex
Cách 1 — Repo-native (không cần cài):
Mở trực tiếp repo bakit trong Codex. Codex sẽ tự đọc AGENTS.md.
Cách 2 — Cài runtime bundle:
bash scripts/install-codex-ba-kit.shKiểm tra: Gõ $ba-start trong Codex. Nếu skill phản hồi đúng là thành công.
Antigravity
bash scripts/install-antigravity-ba-kit.shScript sẽ tạo Knowledge Item ba-kit-workflow và cài CLI ba-kit vào ~/.local/bin.
Kiểm tra: Gõ prompt:
Đọc BA-kit workflow đã cài và chạy status cho project hiện tạiBước 3: Chạy thử
Sau khi cài, chạy thử một lệnh đơn giản để xác nhận mọi thứ hoạt động:
Claude Code:
/ba-startCodex:
$ba-startAntigravity:
Đọc BA-kit workflow đã cài và cho tôi biết các bước chínhBước 4: Kiểm tra bằng doctor
Cả 3 runtime đều hỗ trợ lệnh doctor để kiểm tra cài đặt:
ba-kit doctorOutput thành công trông như thế này:
BA-kit installation check
Runtime: claude-code
Skills: 9 installed
Templates: OK
Rules: OK
Core contracts: OKCách gọi lệnh theo từng runtime
| Tác vụ | Claude Code | Codex | Antigravity |
|---|---|---|---|
| Bắt đầu dự án mới | /ba-start | $ba-start | "Đọc BA-kit workflow đã cài và chạy intake" |
| Router tự do | /ba-do [text] | $ba-do [text] | "Đọc skills/ba-do/SKILL.md và route: [text]" |
| Collaboration | /ba-collab [intent] | $ba-collab [intent] | "Đọc BA-kit collaboration workflow và chạy intent: [intent]" |
| Xem trạng thái | /ba-start status --slug X | $ba-start status --slug X | "Đọc skills/ba-start/SKILL.md và run status cho slug X" |
| Figma sync | /ba-figma-sync --slug X --module Y | $ba-figma-sync --slug X --module Y | "Đọc BA-kit workflow và đồng bộ Figma cho slug X, module Y" |
Nếu gặp lỗi
| Lỗi | Cách xử lý |
|---|---|
"permission denied" khi chạy ./install.sh | Chạy chmod +x ./install.sh rồi thử lại |
/ba-start không hoạt động | Kiểm tra ~/.claude/skills/ có thư mục ba-start không |
| "repo not found" khi clone | Bạn chưa được cấp quyền vào private repo. Xem Điều khoản |
ba-kit doctor báo thiếu | Chạy lại script cài đặt |
Tiếp theo
- Cách BA-kit hoạt động — lifecycle, thư mục output, nguyên tắc
- Hướng dẫn từng bước — flow thực tế từ intake đến package
- Chọn runtime — so sánh 3 runtime, chọn cái phù hợp
BA-kit là gì
BA-kit là bộ công cụ BA chuyên nghiệp cho team, có collaboration, governance, packaging và commercial delivery. Dành cho dự án nhiều người, cần bàn giao chính thức.
Cách BA-kit hoạt động
BA-kit vận hành theo lifecycle có gate: intake → options → backbone → module artifacts → compile → package. Tất cả output nằm trong plans/{slug}-{date}/.