yomiyasu là gì
yomiyasu（よみやす） là một kỹ năng biên tập tiếng Nhật dành cho môi trường lập trình AI. Công cụ này sửa các cách diễn đạt thiếu tự nhiên trong văn bản tiếng Nhật do AI tạo ra, viết lại bản thảo thành nội dung dễ đọc hơn và có mật độ thông tin cao hơn.
Dự án có thể được tải vào các môi trường như Codex, Claude Code và Cursor. Công cụ không chỉ thay thế một số từ dễ khiến văn bản trông “giống AI”, mà còn điều chỉnh dựa trên quan hệ chủ-vị, chủ thể hành động, cách dùng tu từ và cấu trúc thông tin của câu.
Dự án do một cá nhân nghiên cứu và phát triển, được phát hành theo MIT License. Có thể tham khảo bài viết giới thiệu dự án để tìm hiểu bối cảnh thiết kế và quy trình kiểm chứng dữ liệu ngữ liệu.
Những vấn đề trong cách viết tiếng Nhật mà công cụ giải quyết
Các lời nhắc thông thường về văn phong thường chỉ cấm những từ như “解像度”, “手触り” hoặc “泥臭い”. Mô hình có thể thay thế chúng bằng các từ mơ hồ khác, trong khi vấn đề cú pháp ban đầu vẫn còn. Quá nhiều quy tắc biên tập cũng có thể khiến mô hình tạo ra từ ngữ mới hoặc cách diễn đạt cường điệu.
yomiyasu chủ yếu xử lý các vấn đề sau:
- Câu không nói rõ ai thực hiện thao tác nào.
- Sử dụng các đại từ chỉ định không rõ nghĩa như “これ”, “両者” hoặc “片方”.
- Để khái niệm hoặc công cụ làm chủ thể được nhân hóa.
- Sử dụng các động từ ẩn dụ mơ hồ như “壊れる”, “倒す”, “効く”, “溶かす” hoặc “潰す”.
- Xếp chồng chữ in đậm, danh sách và câu mở đầu cố định, nhưng bỏ qua các bước thực tế cùng cơ chế hoạt động.
- Thêm chủ thể, thông số, tuyên bố miễn trừ trách nhiệm hoặc kết luận chung không có trong bản gốc.
Bảy nguyên tắc chuyển đổi cốt lõi
- Khôi phục cấu trúc SVOCM đầy đủ: Làm rõ chủ thể hành động như nhà phát triển, người dùng hoặc hệ thống, đồng thời chuyển đại từ mơ hồ thành danh từ cụ thể.
- Phân biệt chủ thể và mục đích diễn đạt: Với yêu cầu hướng đến độc giả, hãy dùng lời đề nghị rõ ràng; với phần mô tả chức năng, hãy viết rõ hệ thống có thể thực hiện điều gì.
- Phân tách chủ thể vô tri: Chuyển cách mô tả được nhân hóa thành thao tác khách quan do con người hoặc hệ thống thực hiện.
- Chuyển động từ ẩn dụ thành thao tác kỹ thuật: Mô tả trực tiếp các trạng thái như xử lý, bỏ qua, chấm dứt, giảm hoặc xảy ra không nhất quán.
- Xóa phần dẫn nhập thừa: Lược bỏ các câu sáo rỗng như “điều quan trọng là”, đồng thời chuyển phủ định kép và phép đối lập tu từ thành câu khẳng định ngắn gọn.
- Giữ nguyên ý nghĩa: Bảo toàn các giá trị số và ràng buộc kỹ thuật, không tự ý bổ sung sự thật không có trong bản thảo gốc.
- Kiểm soát độ dài câu và phần trang trí: Lấy 30 đến 45 ký tự tiếng Nhật mỗi câu làm tham khảo, giới hạn dấu phẩy trong mỗi câu ở mức 0 đến 2, đồng thời giảm biểu tượng cảm xúc, dấu hai chấm cuối câu, chữ in đậm và khoảng trắng bán độ rộng không cần thiết.
Cài đặt yomiyasu
Cách 1: Sử dụng skills add
Đây là phương thức cài đặt được README khuyến nghị. Sau khi chạy lệnh dưới đây, công cụ sẽ cài đặt kỹ năng vào thư mục cấu hình của các tác nhân như Claude Code:
npx skills add nanaism/yomiyasuCách 2: Dùng cho Cursor hoặc Codex
Có thể cài đặt và đồng bộ kỹ năng bằng OpenSkills:
npx openskills install nanaism/yomiyasu
npx openskills syncSau khi đồng bộ, các tác nhân có thể sử dụng kỹ năng thông qua AGENTS.md.
Cách 3: Cài đặt plugin Claude Code
Trong Claude Code, lần lượt thực hiện:
/plugin marketplace add nanaism/yomiyasu
/plugin install yomiyasu@yomiyasuCách 4: Đặt thủ công
Tải yomiyasu.skill từ GitHub Releases, giải nén rồi đặt vào thư mục kỹ năng của tác nhân đang sử dụng.
Nếu cùng môi trường đang bật các kỹ năng hiệu đính tiếng Nhật hoặc điều chỉnh văn phong khác, các chỉ thị có thể xung đột. Khi sử dụng yomiyasu, nên tạm thời tắt những kỹ năng có chức năng tương tự.
Cách sử dụng cơ bản
Sau khi cài đặt, hãy dán bản thảo tiếng Nhật vào giao diện trò chuyện AI hoặc tác nhân lập trình, rồi đưa ra yêu cầu biên tập đơn giản:
この文章を読みやすくして。
（ここに修正したい文章を貼り付け）Nếu không chỉ định mục đích sử dụng, yomiyasu sẽ tự động xác định lĩnh vực phù hợp dựa trên nội dung đầu vào. Công cụ cố gắng giữ nguyên sự kiện, giá trị số và giới hạn kỹ thuật của bản thảo, đồng thời sửa quan hệ chủ thể-vị ngữ, cách diễn đạt trừu tượng và phần trang trí quá mức.
Ví dụ đơn giản
Giả sử bản gốc sử dụng cách diễn đạt sau:
DBの負荷を逃がし、失敗したメッセージを潰していきます。Có thể yêu cầu yomiyasu chuyển ẩn dụ thành thao tác cụ thể. Theo nguyên tắc biên tập của dự án, kết quả viết lại cần nêu rõ hệ thống giảm tải như thế nào và xử lý thông báo thất bại ra sao, chẳng hạn kéo dài thời gian chờ giữa các lần thử lại rồi chuyển dữ liệu vượt quá số lần thử lại quy định vào hàng đợi thư chết. Kết quả thực tế sẽ được quyết định dựa trên toàn bộ ngữ cảnh; không thể chỉ dựa vào một câu để bổ sung thông số không có trong bản gốc.
Chỉ định văn phong theo mục đích
Nếu cần kết quả ổn định hơn, có thể chỉ định lĩnh vực trong lời nhắc. Dự án cung cấp ba loại hướng dẫn: tech, business và essay.
Bài viết kỹ thuật: tech
Chế độ này phù hợp với blog kỹ thuật và phần mô tả mã nguồn. Chế độ ưu tiên khôi phục các bước thao tác cùng cơ chế triển khai, đồng thời hạn chế những danh sách không cần thiết.
この文章を技術記事向けに読みやすくして。
（ここに修正したい文章を貼り付け）Cũng có thể ghi rõ lĩnh vực:
ドメイン tech
この文章を読みやすくして。
（ここに修正したい文章を貼り付け）Tài liệu nghiệp vụ: business
Chế độ này phù hợp với tài liệu đặc tả, thông cáo báo chí và đề xuất. Chế độ tập trung xóa ẩn dụ, đồng thời làm rõ điều kiện biên và chủ thể chịu trách nhiệm.
ドメイン business
この文章を業務仕様向けに読みやすくして。
（ここに修正したい文章を貼り付け）Tản văn: essay
Chế độ này phù hợp với blog cá nhân và bài viết trên note. Chế độ tránh cường điệu hóa trải nghiệm thông thường thành bài học, đồng thời giữ lại cảm nhận tự nhiên và trải nghiệm cá nhân.
ドメイン essay
この文章をエッセイ向けに読みやすくして。
（ここに修正したい文章を貼り付け）Định lượng dấu vết AI bằng trình kiểm tra tích hợp
Kho lưu trữ đi kèm scripts/yomiyasu_lint.py. Tập lệnh này có thể kiểm tra các hiện tượng như ẩn dụ thiếu tự nhiên, quá nhiều chữ in đậm hoặc danh sách, biểu tượng cảm xúc, dấu hai chấm cuối câu và việc cùng một đuôi câu xuất hiện liên tiếp.
Trình kiểm tra chỉ phụ thuộc vào thư viện chuẩn của Python, không cần cài thêm gói bên thứ ba. Khi kiểm tra tệp Markdown, hãy thực hiện:
python3 scripts/yomiyasu_lint.py README.mdBáo cáo sẽ hiển thị tổng điểm, số ký tự, số dòng, số lượng chữ in đậm trên mỗi nghìn ký tự và tỷ lệ danh sách. Nếu không có quy tắc nào bị kích hoạt, kết quả sẽ hiển thị PASS.
Bật chế độ nghiêm ngặt trong CI hoặc Git Hook
Sau khi thêm --strict, chỉ cần có cảnh báo là tập lệnh sẽ trả về mã thoát 1:
python3 scripts/yomiyasu_lint.py article.md --strictVì vậy, có thể đưa lệnh này vào quy trình tích hợp liên tục hoặc Git Hook trước khi commit, nhằm ngăn các bài viết có vấn đề văn phong rõ ràng đi tiếp trong quy trình.
Gợi ý sử dụng nâng cao
Xác định nội dung trước, biên tập sau
Mục tiêu của yomiyasu là điều chỉnh cách diễn đạt, không thay thế việc kiểm chứng sự thật. Trước khi nhập nội dung, cần xác nhận các tham số, điều kiện giới hạn và kết luận kỹ thuật trong bản thảo gốc. Nhờ đó, có thể phát huy nguyên tắc giữ nguyên ý nghĩa và giảm nguy cơ sai lệch sự thật trong quá trình biên tập.
Nêu rõ độc giả và mục đích trong lời nhắc
Ngoài tên lĩnh vực, có thể giữ lại ngữ cảnh cần thiết trong bản thảo, chẳng hạn bài viết hướng đến nhà phát triển hay nhân viên nghiệp vụ. Dự án xác nhận rõ ba chế độ lĩnh vực, vì vậy không nên cho rằng công cụ tích hợp các chế độ chuyên dụng khác chưa được đề cập trong README.
Kết hợp kiểm tra thủ công với lint
Trình kiểm tra dùng để phát hiện các vấn đề hình thức thuộc phạm vi quy tắc được thiết lập sẵn, không thể thay thế phán đoán của con người. Nên để tác nhân viết lại trước, sau đó chạy yomiyasu_lint.py, cuối cùng kiểm tra thủ công sự chính xác của thông tin kỹ thuật, giọng điệu và phong cách của tác giả gốc.
Tìm hiểu nguồn gốc các quy tắc trong kho lưu trữ
Điểm bắt đầu của kỹ năng cốt lõi nằm trong SKILL.md. Các nguyên tắc chuyển đổi cú pháp, danh mục từ ngữ và cấu trúc thiếu tự nhiên, cùng các quy tắc theo lĩnh vực lần lượt nằm trong thư mục references. Dữ liệu kiểm chứng so sánh nằm trong evals/comparison_benchmark.md. Khi cần nghiên cứu hoặc điều chỉnh hành vi của kỹ năng, có thể bắt đầu đọc từ các tệp này.
Kết luận
yomiyasu chuyển trọng tâm của việc biên tập tiếng Nhật từ cấm từng từ phổ biến sang cấu trúc cú pháp, quan hệ chủ thể, thao tác kỹ thuật và mật độ thông tin. Bằng cách kết hợp lời nhắc theo lĩnh vực phù hợp, kiểm tra thủ công và công cụ lint tích hợp, có thể xây dựng quy trình biên tập tiếng Nhật bằng AI phù hợp với bài viết kỹ thuật, tài liệu nghiệp vụ và tản văn.