---
name: documentation-expert
description: Skill này chuyên trách việc viết và duy trì tài liệu kỹ thuật (Documentation) bằng TIẾNG VIỆT. Đảm bảo tài liệu luôn cập nhật, dễ hiểu cho cả con người và AI, bao gồm README, API docs, và hướng dẫn kiến trúc.
risk: low
source: community
---

# Documentation Expert (Tiếng Việt)

Skill này đảm bảo dự án luôn có hệ thống tài liệu chất lượng cao, giúp việc bàn giao và phát triển tiếp nối trở nên dễ dàng hơn bao giờ hết.

## Khi nào sử dụng
- Khi kết thúc một tính năng lớn hoặc một giai đoạn phát triển.
- Khi cấu trúc dự án có sự thay đổi (như Refactor kiến trúc).
- Khi cần hướng dẫn cài đặt và vận hành hệ thống.

## Các loại tài liệu cần duy trì

1.  **Project README**: Tổng quan về dự án, cách cài đặt và chạy môi trường phát triển.
2.  **Architecture Docs**: Giải thích về Clean Architecture, cách phân lớp và luồng dữ liệu.
3.  **Module Docs**: Chi tiết về từng module quan trọng trong ứng dụng.

## Nguyên tắc viết tài liệu
- **Ngắn gọn & Súc tích**: Không viết lan man, tập trung vào giá trị sử dụng.
- **Có ví dụ**: Luôn đi kèm ví dụ code minh họa.
- **Sơ đồ hóa**: Sử dụng Mermaid diagrams (nếu có thể) để mô tả luồng logic.
- **Cập nhật**: Tài liệu phải phản ánh đúng thực tế mã nguồn hiện tại.

## Cấu trúc tài liệu chuẩn
- Mục tiêu (Objective)
- Yêu cầu hệ thống (Prerequisites)
- Hướng dẫn cài đặt (Installation)
- Cấu trúc thư mục (Directory Structure)
- Luồng xử lý chính (Main Flow)
- Ghi chú bảo mật & Hiệu năng (Notes)

## Checklist viết Docs
- [ ] Tài liệu có đầy đủ mục lục không?
- [ ] Các lệnh terminal có đúng không?
- [ ] Hình ảnh hoặc sơ đồ có hiển thị rõ ràng không?
- [ ] Ngôn ngữ tiếng Việt có chuyên nghiệp và nhất quán không?