Đây là Custom Skill điều phối và chuẩn hóa quy trình biên soạn tài liệu giảng dạy, sách hướng dẫn chuyên môn và quy trình vận hành dành cho AI Agent Antigravity.
graph TD
Start[Người dùng gõ lệnh /writer-orchestrator] --> Question{AI hiển thị câu hỏi điều hướng}
Question -- Lựa chọn 1: Tài liệu chuẩn hóa --> DiataxisMode[Kích hoạt diataxis-writer]
Question -- Lựa chọn 2: Sáng tác sách dài hơi --> BookMode[Kích hoạt write/book-chapter]
DiataxisMode --> DiataxisRules[Áp dụng quy tắc Diataxis:<br>Tutorial / How-to / Reference / Explanation]
BookMode --> BookRules[Áp dụng quy tắc Book Chapter:<br>Cold Pedagogy / Recap-Build-Bridge / RAC]
DiataxisRules --> Brief[AI gọi scripts/orchestrator.py<br>Dựng Content Brief mẫu từ tài nguyên local]
BookRules --> Brief
Brief --> UserInput[Người dùng điền thông tin Content Brief]
UserInput --> Plan[AI lập kế hoạch thực hiện Implementation Plan]
Plan --> Scan[AI soạn thảo & chạy quy trình SCAN tự động rà soát lỗi<br>Cấm em-dash, Oxford comma, dấu hai chấm thừa]
Scan --> Export[Xuất bản tài liệu:<br>Markdown / Word / HTML]
- Điều hướng thông minh: AI tự động hỏi và nhận diện mục đích viết của người dùng ngay khi khởi chạy.
- Tích hợp hai chế độ viết chuẩn hóa:
- Tài liệu chuẩn hóa (Diataxis): Thiết kế tài liệu hướng dẫn kỹ thuật, cẩm nang, tài liệu vận hành (SOP) theo phương pháp Diataxis quốc tế.
- Sáng tác sách chuyên môn (Book Chapter): Viết các chương sách dài hơi (>5.000 từ) tích hợp các phương pháp sư phạm thực tế (Cold Pedagogy, Recap-Build-Bridge, RAC).
- Tự động hóa SCAN rà soát lỗi: Tự động tích hợp bộ lọc ngăn chặn các lỗi ký tự em-dash (
-), kiểm soát dấu phẩy Oxford và dấu hai chấm.
writer-orchestrator/
├── .gitignore
├── SKILL.md # Tệp định nghĩa và cấu hình chính của Skill
├── README.md # Hướng dẫn sử dụng chi tiết (tệp này)
├── evals/
│ └── evals.json # Dữ liệu test đánh giá tự động (evals) từ diataxis-writer
├── scripts/
│ ├── orchestrator.py # Script Python xử lý dựng Content Brief
│ └── classify-doc.sh # Script shell hỗ trợ phân loại loại hình tài liệu
├── references/
│ ├── diataxis_rules.md # Tài liệu tóm tắt quy tắc viết Diataxis
│ ├── diataxis-patterns.md # Chi tiết các template và anti-patterns của Diataxis
│ ├── diataxis_skill_origin.md # Bản sao lưu trữ hướng dẫn gốc của diataxis-writer
│ └── book_chapter_rules.md # Tài liệu quy tắc viết chương sách chuyên sâu
└── resources/
├── brief_template.yaml # Mẫu Content Brief cấu hình
├── pattern-catalog.md # Danh mục 54 pattern viết tiếng Việt chuyên nghiệp
├── write/
│ └── book-chapter.md # Quy định chi tiết module viết chương sách
└── check/ # Bộ quy tắc rà soát lỗi của viet-chuyen-nghiep
├── consistency.md # Kiểm tra tính nhất quán thuật ngữ
├── fact-check.md # Kiểm chứng số liệu thực tế
├── prose-format.md # Chuẩn hóa cấu trúc đoạn văn
└── punctuation.md # Rà soát lỗi ký tự em-dash, Oxford comma, dấu hai chấm
Trong bất kỳ phiên làm việc nào với Antigravity, anh chỉ cần gõ lệnh sau để khởi chạy:
/writer-orchestratorHoặc đưa ra yêu cầu viết lách thông thường:
Tôi muốn soạn thảo một tài liệu mới cho lớp học.
AI sẽ nhận diện và đưa ra câu hỏi trắc nghiệm để anh lựa chọn chế độ viết phù hợp.