Văn phong dịch máy
CAL001 SYN001 LND001
Câu bị động và chủ ngữ giả chép từ tiếng Anh, đúng ngữ pháp nhưng sai giọng.
AI viết
Nền tảng được thiết kế bởi đội ngũ kỹ sư.
Nên viết
Nền tảng do đội ngũ kỹ sư thiết kế.
Tiếng Việt chuẩn,
không giọng dịch
16 skill và một trình kiểm tra giúp agent viết đúng từ bản nháp đầu.
Cài 16 skill miễn phíGiấy phép PolyForm Shield 489 cặp viết sai và viết đúng để đánh giá Không cần cài gói pip
- Nền tảng được thiết kế bởi đội ngũ kỹ sư Việt Nam.CAL001LND001
- Trợ lý AI tốt nhất thị trường, chỉ 299000đ/tháng.LAW001NUM002
- Nó là quan trọng để bạn lưu lại mã ưu đãi.SYN001
- Ưu đãi kết thúc vào 12/25/2026.DATE001
- Nền tảng do đội ngũ kỹ sư Việt Nam thiết kế.
- Trợ lý AI cho đội vận hành, chỉ 299.000 ₫/tháng.
- Bạn nhớ lưu lại mã ưu đãi.
- Ưu đãi kết thúc vào 25/12/2026.
$ python3 validate_copy.py draft.md \ --register saas --doctype hero
1:10: error CAL001 calque “được thiết kế bởi”
1:10: warn LND001 passive English construction “được thiết kế bởi” in hero copy
2:11: warn LAW001 regulated superlative “tốt nhất”
2:36: warn NUM002 ungrouped currency amount “299000đ”
3:1: warn SYN001 dummy-subject calque “Nó là quan trọng/cần thiết để”
4:21: error DATE001 date “12/25/2026” looks like MM/dd/yyyy
1 file(s) checked · 2 error(s) · 4 warning(s)
1 file(s) checked · 0 error(s) · 0 warning(s)
clean
Năm lỗi AI lặp lại mỗi lần viết tiếng Việt
Đọc lướt thì ổn, nhưng người Việt đọc là biết máy viết. Vài lỗi còn vi phạm luật hoặc làm hỏng dữ liệu.
Từ so sánh tuyệt đối
LAW001
Luật Quảng cáo Điều 8 khoản 11 cấm “tốt nhất”, “số một”, “duy nhất” khi không có tài liệu chứng minh.
AI viết
Giải pháp tốt nhất thị trường.
Nên viết
Đối soát 3 kênh thanh toán trên một màn hình.
Tiền và ngày kiểu Mỹ
NUM002 DATE001
Người Việt đọc 12/25 là tháng 25. Số tiền cần dấu chấm phân cách hàng nghìn.
AI viết
299000đ, hết hạn 12/25/2026
Nên viết
299.000 ₫, hết hạn 25/12/2026
Dấu chồng tầng bị cắt
check_font_coverage.py
Dấu mũ cộng dấu thanh cao hơn chữ hoa Latin từ 25% đến 38%. Line height kiểu tiếng Anh cắt mất dấu.
line-height 1, overflow hiddenỄỘỮ
line-height 1.2ỄỘỮ
Unicode tổ hợp và lỗi mã hóa
NFC001 ENC001
Văn bản dán từ macOS, Google Docs hay PDF thường ở dạng NFD hoặc bị mã hóa hai lần. Tìm kiếm và so khớp đều hỏng.
AI viết
Thanh toán thà nh công
Nên viết
Thanh toán thành công
Tiếng Việt không phải là bản dịch. Agent của bạn cũng đừng viết như một bản dịch.
16 skill, mỗi skill một lĩnh vực
Mỗi skill có đủ SKILL.md, tài liệu tham chiếu và bản validate_copy.py riêng. Ngoài quy tắc riêng, skill nào cũng chạy 22 quy tắc lõi: Unicode, mã hóa, calque, luật quảng cáo, số, ngày, ICU, xưng hô và ngữ cảnh viết.
vn-design-system-ux
Giao diện đọc như người Việt viết, không vỡ dấu. Microcopy cho mọi trạng thái, token chữ tiếng Việt, giới hạn độ dài nút và thẻ, đối soát en.json với vi.json.
UX001…UX0077 quy tắcvietnamese-landing-copy
Landing page đúng giọng, đúng luật ngay từ bản nháp đầu. Công thức hero và CTA, form thu thập dữ liệu theo Luật 91/2025/QH15, chân trang theo Nghị định 52/2013 và 85/2021.
LND001…LND0044 quy tắcvietnamese-tech-writing
Tài liệu kỹ thuật mà lập trình viên Việt đọc không vấp. README, API reference, ADR, runbook, postmortem và release note, kèm quy tắc trộn thuật ngữ Anh và Việt.
ENG001…ENG008PROD002…PROD0047 quy tắcvietnamese-business-comms
Văn bản công việc gửi đi đúng chuẩn ngay lần đầu. Công văn theo Nghị định 30/2020, email B2B, báo giá và tin nhắn Zalo ZNS.
ADMIN MKT SALES SPAM ZNS10 quy tắcvietnamese-finance-copy
Nội dung tài chính dùng đúng thuật ngữ và đúng thông tư hiện hành. Ngân hàng số, VietQR và Napas 247, hóa đơn điện tử, báo cáo theo Thông tư 99/2025 thay cho Thông tư 200/2014.
FIN001…FIN0097 quy tắcvietnamese-education-copy
Nội dung giáo dục ghi đúng mức đánh giá của từng cấp học. Từ mầm non đến tiến sĩ và GS/PGS, mỗi cấp theo thông tư riêng. THCS và THPT dùng bốn mức Tốt, Khá, Đạt, Chưa đạt.
EDU001…EDU01212 quy tắcvietnamese-healthcare-copy
Nội dung y tế đúng thuật ngữ và không hứa chữa khỏi. Bệnh án điện tử, đơn thuốc điện tử, giấy ra viện và quảng cáo thực phẩm chức năng theo Nghị định 15/2018.
MED001…MED0077 quy tắcvietnamese-legal-contracts
Hợp đồng soạn đúng điều luật, không vượt trần phạt. Hợp đồng dân sự, thương mại, lao động và điều khoản dịch vụ. Phạt vi phạm tối đa 8% theo Luật Thương mại 2005 Điều 301.
LEG001…LEG0077 quy tắcvietnamese-hospitality-travel
Khách sạn, hàng không và nhà hàng ghi giá rõ ràng. Hạng sao từ 1 đến 5 theo Luật Du lịch 2017, giá net hay ++ kèm phí dịch vụ và VAT, quyền hành khách khi chuyến bay chậm hoặc hủy.
HOS001…HOS0066 quy tắcvietnamese-hr-recruitment
Tin tuyển dụng và thư mời nhận việc không phạm luật lao động. JD không phân biệt đối xử, thư mời ghi rõ gross hay net, lương thử việc tối thiểu 85% theo Bộ luật Lao động 2019.
HR001…HR0066 quy tắcvietnamese-real-estate-construction
Dự án bất động sản ghi đúng mức đặt cọc và tiến độ thanh toán. Cọc tối đa 5% và các mốc 30%, 70%, 95% theo Luật Kinh doanh bất động sản 2023, diện tích thông thủy, quỹ bảo trì 2%.
REA001…REA0066 quy tắcvietnamese-ecommerce-retail
Trang bán hàng gắn đúng nhãn, khuyến mại đúng trần. Phân biệt “Đã thông báo” với “Đã đăng ký” của Bộ Công Thương, khuyến mại tối đa 50% theo Nghị định 128/2024, quyền đổi trả của người mua.
ECOM001…ECOM0066 quy tắcvietnamese-government-public-service
Dịch vụ công nói rõ toàn trình hay một phần, VNeID mức nào. Phân loại theo Nghị định 42/2022, VNeID mức 1 và mức 2 theo Nghị định 69/2024, thẻ căn cước, không còn sổ hộ khẩu giấy.
GOV001…GOV0066 quy tắcvietnamese-insurance-insurtech
Nội dung bảo hiểm nêu đủ quyền của người mua. 21 ngày cân nhắc, loại trừ trách nhiệm phải nêu rõ, bồi thường trong 15 ngày, không giả dạng tiền gửi tiết kiệm.
INS001…INS0066 quy tắcvietnamese-cybersecurity-infosec
Thông báo sự cố và lộ dữ liệu đúng hạn 72 giờ. Báo cáo vi phạm dữ liệu cá nhân cho Bộ Công an theo Luật 91/2025/QH15, hệ thống thông tin cấp độ 1 đến 5, cảnh báo CVE.
SEC001…SEC0066 quy tắcvietnamese-media-journalism-pr
Thông cáo và bài báo giữ nguyên tắc suy đoán vô tội. Đính chính theo Điều 42 Luật Báo chí 2016, phân biệt nghi phạm, bị can, bị cáo, bảo vệ danh tính trẻ em.
MEDJ001…MEDJ0066 quy tắc
Ba bước, không đổi quy trình đang có
Skill định hướng agent lúc viết. Validator chặn lỗi lúc kiểm tra. Hai lớp dùng chung một bộ quy tắc.
Bước 1
Cài skill
Chép thư mục skills vào nơi agent đọc quy tắc.
cp -r design-os-vietnamese/skills/* ~/.claude/skills/Bước 2
Agent tự chọn skill
Khi bạn nhờ viết landing page, công văn hay thông báo lỗi bằng tiếng Việt, agent đọc mô tả và nạp đúng skill trong 16 skill.
Bước 3
Kiểm tra trước khi phát hành
Chạy trong CI. --strict trả mã lỗi khi còn cảnh báo, --json cho máy đọc.
python3 validate_copy.py landing.md --register saas --strictMọi con số ở đây đều kiểm chứng lại được
Không có logo khách hàng hay lời khen dựng sẵn. Chỉ có lệnh và kết quả, chạy trên bản v5.2.0 ngày 29/10/2026.
python3 -m unittest discover -s tests148 test · OK, 8 bỏ quacat evals/v*/pairs.jsonl | wc -l489 cặp sai và đúngvalidate_copy.py --domain all --list-rules | wc -l131 quy tắc22 quy tắc lõi dùng cho mọi skill, cộng 109 quy tắc riêng của 16 lĩnh vực.
python3 tools/verify_ukmc.py18 học phần, 126 neo SHA-256Mỗi trích dẫn ghim nguồn bằng SHA-256 và được đối chiếu nguyên văn với hồ sơ nguồn trong knowledge/_evidence. Kết luận của công cụ: STOP_SUFFICIENT.
check_font_coverage.py index.htmlcleanFont Manrope và Geist Mono của chính trang này, kiểm bằng công cụ trong repo.
Câu hỏi thường gặp
Tôi có cần Claude Code không?
Không bắt buộc. Skill chạy trên Claude Code, Codex, Gemini CLI và Antigravity. Với Claude Code, bạn cài bằng plugin hoặc chép skill vào ~/.claude/skills. Lệnh ở mục Cài đặt chép 16 skill vào cả bốn thư mục skill của các agent trên.
validate_copy.py cần cài những gì?
Python 3.9 trở lên. Tất cả script chỉ dùng thư viện chuẩn, không cần pip.
Validator có bắt được mọi lỗi dịch máy không?
Không. Validator so khớp theo mẫu nên chỉ bắt được các lỗi đã mô tả. Skill giúp agent tránh lỗi ngay lúc viết, còn người đọc lại vẫn là bước cuối.
Dùng trong CI được không?
Được. Thêm --strict để lệnh trả mã khác 0 khi còn cảnh báo, và --json để đưa kết quả vào báo cáo của pipeline. Repo cũng có sẵn hook pre-commit cho validate-copy, check-i18n-parity và check-font-coverage.
Nội dung pháp lý có cập nhật không?
Có. 18 học phần tri thức ghim từng trích dẫn bằng SHA-256, và lệnh python3 tools/verify_ukmc.py kiểm lại chúng với hồ sơ nguồn. Bộ tri thức gồm Luật 75/2025/QH15, Luật 91/2025/QH15 và Thông tư 99/2025/TT-BTC. Đây là công cụ hỗ trợ viết, không phải tư vấn pháp lý.
Vì sao chỗ xưng “bạn”, chỗ xưng “Quý khách”?
Tiếng Việt không có một chữ “you” trung tính. Skill dùng ma trận 31 ngữ vực: SaaS gọi “bạn”, bất động sản cao cấp gọi “Quý khách”, B2B gọi “anh/chị”. Trộn hai ngữ vực trong một trang sẽ bị PRO001 bắt.
Giấy phép là gì?
PolyForm Shield 1.0.0. Mã nguồn công khai: bạn đọc, chạy và sửa được, kể cả đưa vào sản phẩm thương mại của mình, nhưng không được dùng nó để làm sản phẩm cạnh tranh với chính dự án. Điều khoản đầy đủ nằm trong file LICENSE.
Cài 16 skill miễn phí
Một khối lệnh chép đủ 16 skill vào bốn thư mục skill của Claude Code, Codex, Gemini CLI và Antigravity. Mở lại agent là dùng được ngay.
git clone https://github.com/jangtrinh/design-os-vietnamese /tmp/design-os-vietnamese
mkdir -p ~/.claude/skills ~/.codex/skills ~/.gemini/config/skills ~/.agents/skills
cp -R /tmp/design-os-vietnamese/skills/* ~/.claude/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.codex/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.gemini/config/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.agents/skills/
rm -rf /tmp/design-os-vietnameseDùng Claude Code? Cài bằng plugin: /plugin marketplace add jangtrinh/design-os-vietnamese rồi /plugin install design-os-vietnamese@design-os-vietnamese.