BA-kit Agent Skill

Full-stack Business Analysis skill theo chuẩn Agent Skills — tương thích Claude Code, Cursor, VS Code, Kiro, Gemini CLI, và 40+ agentic clients khác.

Cài đặt

Claude Code

Cách 1 — Global (dùng được ở mọi project):

git clone git@github.com:SoftwareOneHN/ba-kit.git ~/.claude/skills/ba-kit

Cách 2 — Project-level (chỉ áp dụng cho 1 project):

git clone git@github.com:SoftwareOneHN/ba-kit.git .claude/skills/ba-kit

Cách 3 — Symlink (dev workflow, dễ pull updates):

git clone git@github.com:SoftwareOneHN/ba-kit.git ~/Projects/ba-kit
ln -s ~/Projects/ba-kit ~/.claude/skills/ba-kit

Global vs Project-level: ~/.claude/skills/ là global — skill tự động available trong mọi project. .claude/skills/ (trong repo) là project-level — chỉ hoạt động khi bạn đang ở repo đó.

Verify: ls ~/.claude/skills/ba-kit/SKILL.md — thấy file là OK.

Cursor / VS Code

Copy thư mục ba-kit/ vào .cursor/skills/ hoặc .vscode/skills/.

Kiro

Copy thư mục ba-kit/ vào .kiro/skills/ hoặc cài từ Power registry.

Bất kỳ Agent Skills client nào

Đặt thư mục ba-kit/ vào vị trí skills mà client hỗ trợ.

Cấu trúc

ba-kit/
├── SKILL.md              # Required: metadata + core instructions (~200 lines)
├── README.md             # File này
└── references/           # Detailed docs (loaded on-demand)
    ├── contract-data.md          # Full paths, states, YAML contract
    ├── contract-behavior.md      # LLM behavior policy
    ├── steps-intake.md           # Intake workflow
    ├── steps-backbone.md         # Backbone workflow
    ├── steps-frd.md              # FRD workflow
    ├── steps-stories.md          # User stories workflow
    ├── steps-srs-core.md         # SRS Groups A/B/C
    ├── steps-srs-wireframes.md   # SRS Groups D/E
    ├── steps-srs-assembly.md     # SRS Group F + assembly
    ├── steps-wireframes.md       # Wireframe handoff
    ├── steps-package.md          # HTML packaging
    ├── impact.md                 # Change impact triage
    ├── quality-rules.md          # Quality standards
    ├── templates.md              # Full template catalog
    ├── delegation.md             # Multi-BA governance
    ├── agents.md                 # Agent delegation specs
    ├── skill-collab.md           # Collaboration & GitHub
    ├── skill-next.md             # Next step detection
    └── skill-notion.md           # Notion publishing

Progressive Disclosure

Theo chuẩn Agent Skills, skill hoạt động theo 3 giai đoạn:

1. Discovery (~100 tokens): Chỉ load name + description từ frontmatter
2. Activation (~4000 tokens): Load toàn bộ SKILL.md body khi task match
3. Execution (on-demand): Load reference files cụ thể khi cần chi tiết step

Sử dụng

Sau khi cài, nói tự nhiên:

Bạn nói	Agent làm
"Tạo dự án BA mới"	Intake → gap analysis → scope lock
"Tiếp tục dự án warehouse-rfp"	Detect next step → execute
"Đánh giá thay đổi: thêm audit log"	Impact analysis → recommend path
"Chuẩn bị handoff UI"	Wireframe constraint pack
"Xuất gói bàn giao"	Package → HTML

Chuyển đổi từ Kiro Power

Skill này được chuyển đổi từ ba-kit-power (Kiro Power format) sang chuẩn Agent Skills mở. Nội dung và logic giữ nguyên 100%.

Kiro Power	Agent Skills
POWER.md	SKILL.md
steering/*.md (always)	Inline trong SKILL.md body
steering/*.md (manual)	references/*.md

License

MIT