Cách BA Survival Kit hoạt động

BA Survival Kit hoạt động theo nguyên tắc generator-first: bạn đưa nguyên liệu thô (bản ghi họp, brand book, ghi chú), mô tả điều bạn muốn bằng tiếng Việt, và AI sẽ chọn skill phù hợp để sinh tài liệu.

Không có slash command. Không có ba-start. Bạn nói bằng ngôn ngữ tự nhiên, AI lo phần còn lại.

Mô hình hoạt động

NGUYÊN LIỆU THÔ
(Bản ghi họp, Brand book, Email, Ghi chú)
    │
    ├──────────────────────────────────────┐
    ▼                                      ▼
NHÓM SETUP                            NHÓM SINH TÀI LIỆU
(Chuẩn bị & Cấu hình)                 (Generators)
    │                                      │
    ├── ba-generate-ui-styleguide          ├── ba-generate-srs (flagship)
    │   (Brand → Design system)            ├── ba-generate-brd
    │                                      ├── ba-generate-urd
    └── ba-parse-intake                    ├── ba-generate-prd
        (Lọc rác từ input >5000 từ)        ├── ba-generate-frd
                                           ├── ba-generate-use-cases
                                           ├── ba-generate-user-stories
                                           └── ba-generate-raci
                                               │
                                               ▼
                                        NHÓM REVIEW
                                        (Kiểm định & Đánh bóng)
                                           │
                                           ├── ba-gap-check
                                           │   (So khớp tài liệu với nguồn gốc)
                                           │
                                           └── ba-polish-doc
                                               (Đánh bóng → client-ready)

3 nhóm skill

Nhóm 1: Setup Helpers (2 skill)

Chuẩn bị nguyên liệu trước khi sinh tài liệu chính:

• ba-generate-ui-styleguide: Bóc tách brand book của khách hàng (logo, màu sắc, font) để sinh file figma-make-guidelines.md. Đảm bảo mọi màn hình vẽ ra sau này đồng bộ về màu sắc và phong cách.
• ba-parse-intake: (Không bắt buộc) Dùng khi bản ghi họp quá dài (>5000 từ). AI lọc bớt rác và tóm tắt thành bản brief cô đọng trước khi viết tài liệu chi tiết.

Nhóm 2: Primary Generators (8 skill)

Đây là nhóm chính - mỗi skill sinh ra một loại tài liệu BA:

• ba-generate-srs (flagship): Sinh SRS + đặc tả từng màn hình + message registry + prompt Figma Make copy-paste
• ba-generate-brd: Business Requirements Document - mục tiêu kinh doanh, scope, stakeholders
• ba-generate-urd: User Requirements Document - user personas, pain points, nhu cầu
• ba-generate-prd: Product Requirements Document - product vision, features, metrics
• ba-generate-frd: Functional Requirements Document - logic chức năng, validation rules
• ba-generate-use-cases: Use Cases với Main Flow, Alternative Flow, Exception Flow
• ba-generate-user-stories: User Stories chuẩn "As a / I want / so that" kèm Acceptance Criteria
• ba-generate-raci: Ma trận RACI + Mermaid flowchart cho quy trình nghiệp vụ

Nhóm 3: Reviewers & Polishers (2 skill)

Kiểm tra chất lượng và đánh bóng trước khi bàn giao:

• ba-gap-check: Đối chiếu tài liệu đã viết với nguồn gốc, tìm lỗi logic, mâu thuẫn, giả định chưa được làm rõ. Không sửa tài liệu - chỉ báo cáo.
• ba-polish-doc: Đánh bóng câu từ. 2 chế độ: --internal (giữ câu hỏi thô, cho nội bộ) và --client-ready (viết lại chuyên nghiệp, gom câu hỏi thành agenda).

Tích hợp Figma Make

Điểm mạnh nhất của BA Survival Kit là tích hợp thẳng với Figma Make:

1. ba-generate-srs sinh ra file screen spec, mỗi file có sẵn một khối Figma Make Prompt
2. Bạn copy prompt đó, paste vào Figma Actions → First Draft
3. Figma tự động dựng wireframe trong ~30 giây

Không cần tự vẽ. Không cần mô tả lại giao diện. Prompt đã được sinh sẵn từ SRS.

Shared rules - nguyên tắc dùng chung

Tất cả 12 skill dùng chung bộ rule trong thư mục shared/:

Điểm khác biệt với cách làm BA truyền thống

Tiếp theo

• Danh sách 12 skill - chi tiết từng skill
• Bắt đầu cài đặt - cài trong 2 phút
• So sánh với BA-kit - khi nào cần bản Paid