Bắt đầu với BA Survival Kit

Hướng dẫn này dành cho người chưa từng dùng BA Survival Kit. Sau 2 phút, bạn sẽ cài xong và dùng được skill đầu tiên.

Bạn cần gì trước khi bắt đầu

• Antigravity AI đã cài trên máy (BA Survival Kit được thiết kế cho Antigravity trước tiên)
• Git đã cài (để clone repo)
• Kết nối Internet

Không cần biết code. Không cần biết Git sâu.

Bước 1: Clone repo

Mở Terminal và chạy:

git clone https://github.com/bakit-org/ba-survival-kit.git
cd ba-survival-kit

Repo này chứa toàn bộ 12 skill, templates, shared rules, và scripts.

Bước 2: Cài skill vào Antigravity

Có 2 cách cài:

Cách A: Cài cho riêng dự án này (Workspace)

./scripts/install-antigravity-workspace.sh

Skill chỉ khả dụng khi bạn mở Antigravity trong thư mục ba-survival-kit.

Cách B: Cài toàn máy (Global)

./scripts/install-antigravity-global.sh

Skill khả dụng ở mọi thư mục trên máy. Phù hợp nếu bạn làm nhiều dự án.

Bước 3: Dùng skill đầu tiên

Mở Antigravity trong thư mục dự án, đưa vào một bản ghi họp hoặc tài liệu yêu cầu, và nói bằng tiếng Việt:

Dịch file meeting-notes.txt thành tài liệu SRS và tạo đặc tả màn hình Figma Make

Antigravity sẽ tự động:

1. Đọc skill ba-generate-srs
2. Phân tích bản ghi họp
3. Sinh srs.md - tài liệu đặc tả tổng quan
4. Sinh thư mục srs-screens/ - đặc tả chi tiết từng màn hình
5. Sinh srs-screens/message-registry.md - bảng mã lỗi tập trung

Quy trình 6 bước chuẩn

Bản ghi họp thô + Brand book khách hàng
    │
    ▼
Bước 1: Cài skill (chỉ làm 1 lần)
    │
    ▼
Bước 2: Cấu hình giao diện thương hiệu (ba-generate-ui-styleguide)
    │
    ▼
Bước 3: Sinh SRS & Prompt Figma (ba-generate-srs)
    │
    ├────────────────────────┐
    ▼                        ▼
[srs.md]              [srs-screens/]
                      (Mô tả & Prompts)
                           │
                           ▼
Bước 4: Vẽ UI tự động trên Figma Make (copy-paste prompt)
                           │
                           ▼
Bước 5: Kiểm tra lỗi logic (ba-gap-check)
                           │
                           ▼
Bước 6: Đánh bóng gửi khách (ba-polish-doc)

Ví dụ thực tế: Từ bản ghi họp đến SRS

1. Chuẩn bị style guide (nếu có brand book)

Đọc file brand-book.pdf này và sinh bộ quy chuẩn thiết kế Figma Make

Kết quả: file shared/figma-make-guidelines.md với màu sắc, font, bo góc chuẩn.

2. Sinh SRS từ bản ghi họp

Dịch file meeting-notes.txt thành tài liệu SRS và tạo đặc tả màn hình Figma Make

Kết quả: srs.md + srs-screens/screen-*.md + srs-screens/message-registry.md.

3. Gộp SRS thành một file (tùy chọn)

./scripts/merge-srs.sh

Kết quả: srs-compiled.md - một file duy nhất để gửi khách hàng.

4. Vẽ wireframe trên Figma

1. Mở file thiết kế trong Figma
2. Click Actions (hình ngôi sao) → First Draft
3. Mở file trong srs-screens/, copy phần Figma Make Prompt
4. Paste vào Figma First Draft → Generate
5. Chờ 30 giây để Figma dựng wireframe

5. Kiểm tra lỗi logic

Quét lỗi logic nghiệp vụ và kẽ hở thông tin của file srs.md so với meeting-notes.txt

Kết quả: báo cáo chỉ rõ chỗ nào sai logic, chỗ nào thiếu thông tin.

6. Đánh bóng gửi khách

Đánh bóng tài liệu srs.md sang chế độ client-ready

Kết quả: tài liệu chuyên nghiệp, câu hỏi chưa rõ được gom thành agenda họp tiếp theo.

Khác biệt với BA-kit

BA Survival Kit không có slash command như /ba-start hay /ba-do. Những lệnh đó thuộc về BA-kit - bản dành cho team và commercial delivery.

BA Survival Kit dùng prompt tiếng Việt tự nhiên trong Antigravity. Bạn mô tả điều bạn muốn, AI tự chọn skill phù hợp.

Tiếp theo

• Cách BA Survival Kit hoạt động - mô hình generator-first
• Danh sách 12 skill - mỗi skill làm gì, dùng khi nào
• So sánh với BA-kit - khi nào nên dùng bản nào