| name | doc-workflow-review |
| description | Workflow review tài liệu Workflow Design. Sử dụng để kiểm tra tính hợp lý của luồng nghiệp vụ, phát hiện các dead-end, thiếu sót rẽ nhánh hoặc mâu thuẫn với tài liệu FE/BE. Trigger phrases: review workflow, kiểm tra luồng nghiệp vụ. |
| argument-hint | Đường dẫn file Workflow cần review |
Skill: doc-workflow-review
Mục đích
Đánh giá chất lượng của tài liệu Workflow Design, đảm bảo luồng nghiệp vụ logic, chặt chẽ, không có ngõ cụt (dead-end) và sẵn sàng làm đầu vào cho việc tạo Test Case ITb.
Tiêu chí Review (Checklist)
-
Format & Cấu trúc (20%)
- Có đủ 7 sections theo
TEMPLATE_WORKFLOW.md không?
- Có YAML frontmatter và Change Log không?
-
Tính Logic của Main Flow (30%)
- Các bước có liên kết chặt chẽ với nhau không?
- Có mapping đúng với các API/Screen đã thiết kế không?
- Pre-conditions và Post-conditions có hợp lý không?
-
Sơ đồ Mermaid (20%)
- Sơ đồ có khớp 100% với các bước mô tả trong Main Flow không?
- Syntax Mermaid có hợp lệ không?
-
Bao phủ rẽ nhánh & Ngoại lệ (30%)
- Có bỏ sót Alternative Flow nào hiển nhiên không?
- Các Exception Flows có chỉ rõ Message ID hoặc cách xử lý của hệ thống không?
- Có bước nào dẫn đến "dead-end" (người dùng không biết làm gì tiếp theo) không?
Output Format
Xuất báo cáo ra màn hình chat:
## Doc Review: [Tên Workflow]
File: demo_docs/workflow/...
Score: XX/100
Verdict: ✅ PASS | ⚠️ CONDITIONAL PASS | ❌ FAIL
### Findings
[Critical] ...
[High] ...
[Medium] ...
[Low] ...
### Summary
...