Bộ Skill Claude AI trợ lý viết tài liệu đặc tả Use Case dành cho BA, PO
Use Case Writer — Skill Claude AI dành riêng cho BA/PO
Chào cả nhà BA Zone 👋
Mình là Phúc NT, hôm nay mình muốn chia sẻ với cộng đồng một skill Claude AI mà mình đã build dành riêng cho anh em BA/PO làm nghề: Use Case Writer.
Vì sao mình build skill này?
Trong những năm làm BA và review tài liệu của các bạn BA junior, mình nhận ra Use Case Specification là một trong những artifact bị làm sai nhiều. Không phải vì BA lười, mà vì việc viết một UC chuẩn với một bản mới nếu không có mẫu và người hướng dẫn thì tương đối khó. Những lỗi P thấy các bạn thường gặp phải:
Scope sai : Viết UC quá to (cả workflow “Quản lý đơn hàng”) hoặc quá nhỏ (sub-function như “Verify OTP”)
Actor mơ hồ: BA dùng “User” chung chung thay vì role cụ thể như Learner, Mentor, HR Manager
Nhồi logic vào Normal Course: Chèn if/else, vòng lặp vào flow chính — biến UC thành pseudo-code
Chỉ viết happy path: Bỏ quên Alternative Courses và Exceptions những thứ dev cần nhất.
Lẫn lộn Preconditions với Business Rules với Assumptions
Câu hỏi P đặt ra liệu AI có thể giúp BA viết UC chuẩn ngay từ đầu, và giúp tiết kiệm thời gian hơn?
Sau quá trình tìm hiểu và thử nghiệm, mình đã xây một bộ Skill khá ổn để viết tài liệu đặc tả Use Case hiệu quả.
Skill này khác gì so với việc “chat ChatGPT viết UC”?
Đa số khi prompt thẳng “viết use case cho tính năng X”, AI sẽ cho ra một template điền sẵn đẹp về hình thức nhưng sai về phương pháp luận. Use Case Writer enforce 3 lớp mà một BA senior thật sự sẽ làm:
1. Scope trước, viết sau
Skill áp dụng Cockburn’s Coffee-Break Test + Goal Levels + nguyên tắc one-actor-one-goal-one-session + System Boundary trước khi gõ chữ đầu tiên. Nếu scope sai, AI không viết quay lại bàn lại với user.
2. Sinh tuần tự theo 5 nhóm section, có gate xác nhận
Thay vì đẻ ra cả UC một lúc (rồi sai chỗ nào sửa cả file), skill chia 13 fields thành 5 nhóm, làm xong nhóm nào confirm nhóm đó. Phát hiện sai sớm = tiết kiệm thời gian hơn. Tương tự như khi bạn viết Use Case thủ công thì cần verify và làm rõ yêu cầu với các bên liên quan.
3. Validate bằng 20-point checklist trước khi handover
Mỗi UC được chạy qua 20 tiêu chí kiểm thử chia theo 6 nhóm (Scope, Actor, Conditions, Normal Course, Alternative/Exception, Completeness) y như một code reviewer chạy linter trước khi merge PR.
Skill này làm được gì cho bạn?
Output: English Markdown theo template 13 fields chuẩn Karl Wiegers / IIBA — copy-paste thẳng vào Confluence luôn cho tiện.
4 modes linh hoạt:
Viết UC mới từ feature description
Tách 1 feature lớn thành UC list (dùng 3 kỹ thuật: goal-driven, event-driven, CRUD-driven)
Refine UC đang có
Viết riêng 1 section bất kỳ (vd: chỉ Normal Course)
Bilingual UX: Chat tiếng Việt cho thoải mái, artifact UC vẫn output tiếng Anh chuẩn quốc tế
P soạn sẵn 2 UC mẫu EdTech hoàn chỉnh đã pass 20-point checklist — học theo example tốt hơn học theo lý thuyết suông:
UC-LEARN-01: Enroll Digital School course (có voucher payment, capacity race condition, async LMS retry)
UC-MENTOR-03: Approve 1-on-1 mentor session (có concurrency conflict, quota enforcement, calendar degraded-mode)
Nền tảng học thuật vững: P soạn dựa trên Cockburn (Writing Effective Use Cases), Wiegers & Beatty (Software Requirements), BABOK v3 của IIBA, và Ivar Jacobson không phải prompt “chế” theo cảm tính.
Skill này KHÔNG làm gì?
Để các bạn không kỳ vọng sai:
Không viết Agile User Story đó là artifact khác (mình có skill riêng
user-story-ac-writer)Không viết PRD/URD/SRS đầy đủ UC chỉ là 1 section trong những tài liệu đó
Không vẽ UML Use Case Diagram đây là text spec, không phải diagram
Không làm wireframe/UI mockup: P sẽ viết 1 Skill khác để vẽ mockup.
Không viết Business Process Model — BPM là multi-actor multi-system, UC là 1 actor + 1 system
Cài đặt nhanh
Cách 1 — Claude Code CLI (recommended cho ai dùng VS Code/JetBrains):
# Mac/Linux
git clone https://github.com/phucnt-bazone-vietnam/use-case-writer.git \
~/.claude/skills/use-case-writer
# Windows PowerShell
git clone https://github.com/phucnt-bazone-vietnam/use-case-writer.git `
"$env:USERPROFILE\.claude\skills\use-case-writer"
Sau đó chỉ cần gõ trong Claude Code: “Viết UC cho tính năng đặt lịch mentor” — skill tự kích hoạt theo trigger phrases.
Cách 2 — Upload vào Claude Project trên claude.ai: Tạo Project mới → drag-and-drop cả folder vào knowledge base → xong.
Repo có hướng dẫn chi tiết cho cả 4 phương án cài đặt (user-level, project-level, claude.ai web, one-shot prompt).
Phúc build skill này với 2 mục tiêu:
Giúp BA junior rút ngắn đường cong học việc thay vì mất 6 tháng để hiểu thế nào là một UC “đúng chuẩn”, có một AI mentor enforce kỷ luật ngay từ ngày đầu
Giúp BA senior tiết kiệm thời gian draft focus vào những thứ AI không thay được: stakeholder interview, business judgment, trade-off decision
Skill này là MIT License anh em fork, dùng, sửa thoải mái cho dự án/công ty mình. Chỉ giữ attribution Phúc NT / BA Zone trong các bản phân phối lại. Đó là intellectual property của cộng đồng BA Zone, không phải của riêng một công ty nào.
Nếu các bạn có:
UC examples từ domain khác (banking, insurance, healthcare, e-commerce…)
Anti-patterns mới gặp ngoài thực tế
Đề xuất cải tiến 20-point checklist
→ Mở PR hoặc Issue trên repo nhé. Mình sẽ merge và credit đầy đủ.
Nếu thấy hữu ích, các bạn cho mình xin 1 star ⭐ trên GitHub để mình có động lực ra thêm các skill khác cho BA/PO Việt Nam (sắp tới sẽ có User Story & AC Writer, PRD Writer, Business Rule Generator…). Và bạn có thể Fork về github của bạn để lưu lại dùng nhé.
🔗 Repo viết Use Case bạn xem và tải về tại đây: https://github.com/phucnt-bazone-vietnam/use-case-writer
Phúc NT - BA Zone
P/S: Bạn nào muốn mình viết thêm Skill cho nghiệp vụ hoặc task nào của BA comment mình chia sẻ nhé.