style-guide-vi
Installation
SKILL.md
Style guide tiếng Việt
Quy tắc của người dùng hoặc tổ chức luôn ưu tiên. Mặc định của skill chỉ dùng khi chưa có hướng dẫn và phải được áp dụng nhất quán, không hồi tố tùy tiện lên trích dẫn hoặc tên riêng.
Quy trình
- Tìm style guide, glossary, tài liệu chuẩn hoặc ví dụ đã được duyệt. Ghi rõ nguồn quy tắc.
- Lập bảng quyết định cho xưng hô, thuật ngữ, tên sản phẩm, viết hoa, số, ngày giờ, tiền tệ, đơn vị, dấu câu và định dạng.
- Xác định phạm vi ngoại lệ: code, URL, identifier, tên thương hiệu, trích dẫn, dữ liệu nhập từ hệ thống khác.
- Quét theo từng nhóm thay vì sửa ngẫu nhiên. Ghi lại biến thể và tần suất trước khi chọn dạng chuẩn.
- Nếu không có style riêng, dùng defaults trong references và nói rõ đó là mặc định của dự án.
- Rà chéo để một sửa đổi không tạo mâu thuẫn mới, chẳng hạn đổi xưng hô nhưng bỏ sót động từ lịch sự.
- Xuất bản sạch hoặc báo cáo thay đổi theo yêu cầu.
Đọc terminology trước khi chuẩn hóa thuật ngữ hàng loạt và formatting cho Markdown.
Bảo toàn
Giữ dữ kiện, số trị, đơn vị, tên riêng, tên sản phẩm, trademark, code, URL, identifier và trích dẫn. Chuẩn hóa cách biểu diễn không được đổi giá trị: 1,5 và 1.5 chỉ đổi khi đã xác định quy ước thập phân; múi giờ phải được giữ.