review-report

在提交报告前，对报告进行质量审核与优化调整。适用于在完成报告撰写后，对内容质量、Markdown 格式、Mermaid 流程图，以及阅读体验进行全面检查。包括内容清单、格式清单、可读性评估，以及针对反馈意见的迭代优化流程。

SKILL.md

--- frontmatter

name: review-report
description: "Skill QA và tinh chỉnh báo cáo trước khi submit. Sử dụng sau khi tạo báo cáo để kiểm tra chất lượng nội dung, format markdown, Mermaid diagrams, và trải nghiệm đọc. Bao gồm Content Checklist, Format Checklist, Readability Assessment, và Iteration workflow để xử lý feedback."

Review Report Skill

Skill hướng dẫn QA và tinh chỉnh báo cáo.

Quy trình Review

Bước 1: Content Review

Xem references/qa_checklists.md để checklist chi tiết.

Quick Content Check:

• Executive Summary có thể đọc độc lập và hiểu được
• Thuật ngữ chuyên ngành được giải thích lần đầu xuất hiện
• Có ít nhất 1 ví dụ minh họa cho mỗi concept chính
• Phần Kết luận có ít nhất 1 action item cụ thể
• Tất cả sources được trích dẫn trong References

Bước 2: Format Review

Markdown Check:

• Heading hierarchy đúng (H1 → H2 → H3, không skip)
• Code blocks có syntax highlighting (```language)
• Links hoạt động và format đúng
• Bảng render đúng

Mermaid Check:

• Diagrams render không lỗi
• Labels rõ ràng, không quá dài
• Phù hợp với nội dung mô tả

Bước 3: Readability Assessment

Độ dài phù hợp:

Loại	Target	Acceptable Range
Quick	500-1000 từ	400-1200 từ
Standard	1500-2500 từ	1200-3000 từ
Deep Dive	3000+ từ	2500+ từ

Formatting:

• Paragraphs ngắn (max 4-5 dòng)
• Sử dụng bullet points thay văn xuôi dài
• Có visual breaks (horizontal rules, headings)
• Không có wall of text

Bước 4: Final Polish

• Đọc lại từ đầu đến cuối một lần
• Check typos và grammar
• Đảm bảo tone nhất quán
• Xác nhận target audience phù hợp

Iteration Workflow

Khi nhận feedback cần chỉnh sửa:

mermaid

flowchart LR
    A[Feedback] --> B{Loại?}
    B -->|Sai thông tin| C[Re-research]
    B -->|Thiếu nội dung| D[Add content]
    B -->|Format| E[Fix format]
    B -->|Làm rõ| F[Clarify]
    C --> G[Update report]
    D --> G
    E --> G
    F --> G
    G --> H[Re-review]

Nguyên tắc:

•Không viết lại từ đầu nếu chỉ cần chỉnh nhỏ
•Ghi chú những gì đã thay đổi
•Chạy lại review checklist sau khi sửa

Output Format

markdown

## Review Report

### Summary
- **Status:** ✅ Ready / ⚠️ Needs fixes / ❌ Major issues
- **Issues found:** [Số lượng]

### Content Issues
| # | Issue | Severity | Location | Fix |
|---|-------|----------|----------|-----|
| 1 | [Mô tả] | High/Med/Low | [Section] | [Đề xuất] |

### Format Issues
| # | Issue | Location | Fix |
|---|-------|----------|-----|
| 1 | [Mô tả] | [Line/Section] | [Đề xuất] |

### Readability Score
- Word count: [X] words
- Paragraph avg: [X] lines
- Visual elements: [X] diagrams, [X] tables

### Recommendations
1. [Đề xuất 1]
2. [Đề xuất 2]