# Vina Me

> Văn dễ đọc là văn có câu sau nối với câu trước, có người viết đặt mình vào người nghe, và chỉ nói điều có thật. Số

- Skill: `anhtuan2111/vina-me` (Agent Skill, multi-file: 70 files)
- Install (CLI): `npx get-skill add anhtuan2111/vina-me`
- Raw SKILL.md: https://api.skillmd.com/api/skills/anhtuan2111/vina-me/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: AnhTuan2111 (https://skillmd.com/u/anhtuan2111)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/anhtuan2111/vina-me

---


# Viết cho lưu loát

Văn dễ đọc là văn có câu sau nối với câu trước, có người viết đặt mình vào người nghe, và chỉ nói điều có thật. Số
chữ ít hay nhiều không quyết định điều đó. Skill này không có từ cấm, chỉ có những từ và mẫu câu ngoài đời ít ai nói;
dùng một lần đúng chỗ thì được, dùng thành thói quen thì thành văn AI slop.

**Luật cứng:** viết bất cứ thứ gì có tiếng Việt thì luôn dùng skill này, và gọi nó bằng công cụ Skill trước khi viết: câu trả
lời trong chat dù chỉ vài chữ, tệp, chú thích, commit, issue, PR, chữ trên giao diện. Không viết theo trí nhớ về luật, và
không bỏ qua với lý do đây chỉ là một dòng ngắn.

## Quy trình

1. Xác định viết cho ai, để làm gì, người đọc đã biết gì; loại văn bản và một mục đích chính (`references/document-types.md`).
2. Chọn một cách sắp thông tin (thời gian, nhân quả, mức quan trọng, so sánh) và giữ suốt bài (`references/structure.md`).
3. Chốt tên gọi cho thứ nhắc nhiều lần, chốt xưng hô theo mục Giọng.
4. Viết theo bảy điều dưới. Văn bản dài hay cần soát kỹ thì đọc bản đầy đủ ở `references/core-rules.md`. Trước mỗi lần
   viết hay viết lại văn dài thì đọc lại skill và tệp tham khảo hợp loại, kể cả khi đầu phiên đã đọc; viết theo trí nhớ
   thì giữ được luật câu chữ nhưng hay rơi mất cách dựng bài, nên bài ra kể lể.
5. Soát: `node scripts/lint.mjs <tệp>` nếu chạy được lệnh, rồi đọc lại hai lượt, một lượt làm người chưa biết gì, một
   lượt bắt văn AI slop theo `references/machine-tells.md`. Soát văn của người khác thì chạy lint trên tệp đó và trên chính
   lời soát; lint bỏ qua lời trích trong ngoặc kép, nên báo nào còn lại trong lời soát là của mình. Người dùng muốn có
   điểm thì chấm theo `references/scoring.md`.
6. Trả kết quả theo bảng Trả kết quả. Việc sửa, kiểm tra, chạy thì báo đã kiểm tra gì, chưa kiểm tra gì, chỗ nào chưa chắc.

## Bảy điều cốt lõi

1. Dẫn bằng điều người đọc đang thắc mắc. Bài giảng, giải thích thì hỏi rồi đáp ngay câu sau; không hỏi tu từ,
   không hỏi dồn. Báo cáo, thư công việc thì câu đầu nói ngay đang bàn gì, câu hai là một thứ cụ thể.
2. Mạch lạc rồi mới nối câu. Cả đoạn một đề tài, một trình tự. Câu sau nối câu trước bằng lặp từ khoá, "này, ấy,
   đó", từ nối đúng quan hệ (`references/cohesion.md`) hoặc mốc thời gian. Che câu trước mà câu sau vẫn đứng một mình
   được thì hai câu đang rời nhau.
3. Ý có quan hệ thì viết thành một câu: vì… nên, nếu… thì, tuy… nhưng. Câu 20 tới 30 tiếng không sao; nhịp không
   đều; không rút câu cho vừa một mốc số chữ.
4. Hình trước, tên và định nghĩa sau. Bắt đầu từ vật người đọc đã thấy, kể nó làm gì, rồi mới gọi tên. Chủ ngữ là
   một vật hay một người làm một việc, không phải "cơ chế", "việc triển khai". Câu định nghĩa có "là".
5. Một thứ một tên, mỗi đoạn tối đa một thuật ngữ mới, giải nghĩa ngay lần đầu dùng. Thuật ngữ có tên chuẩn tiếng Anh
   thì giữ nguyên, không dịch (option, không "cờ") (`references/word-choice.md`).
6. Nói thật. Không bịa trải nghiệm, cảm xúc, con số, ví dụ. Chỉ dùng dữ kiện người dùng đưa; thiếu thì hỏi hoặc
   ghi là thiếu. Nói đúng mức chắc chắn. Không khen, không phán xét người đọc (`references/citations-data-figures.md`).
7. Dùng chữ người ta vẫn nói ngoài đời. Thử: giải thích cho người ngồi cạnh thì có nói chữ đó không. Tránh "không
   phải X mà là Y" khi chưa ai nói X, "không chỉ… mà còn…", bộ ba cho đủ vần, mở bằng dựng cảnh, kết bằng "Tóm lại",
   câu châm ngôn; "Hãy…", "hành trình", "đóng vai trò", "chúng ta"; mọi phần cùng một khuôn.

## Dấu gạch và ký hiệu

Không dùng dấu gạch dài, gạch vừa ở bất cứ đâu (cả nhan đề, bảng, code, commit, chat); chêm lời thì dùng dấu phẩy hay
ngoặc đơn, nhan đề viết "A: B", khoảng số viết "3-5". Trong câu văn không dùng mũi tên, dấu tick, emoji, số khoanh tròn,
`~`, `&`, `=`; không in hoa cả chữ để nhấn. Bảng thay thế ở `references/punctuation.md`.

## Giọng

| Văn bản | Xưng hô và giọng |
|---|---|
| Bài giảng, ghi chú, blog, lời giải thích trong chat | "mình, bạn", thân mật có mức |
| Tin nhắn công việc gửi sếp, đồng nghiệp | xưng như lúc nói với người đó, giọng nói chuyện |
| Tài liệu kỹ thuật, hướng dẫn, thông báo gửi khách | trung tính, ít xưng hô |
| Báo cáo, kiến nghị, thư công việc | trang trọng, theo cách xưng hô của nơi nhận; gửi cả nhóm thì không xưng hô |
| Văn bản hành chính nhà nước | không xưng hô, chủ ngữ là cơ quan (`references/official-documents.md`) |

Chi tiết từng loại ở `references/document-types.md`. Người dùng chỉ định giọng thì theo lời đó; viết theo giọng một người
cụ thể thì tra `references/voice.md`.

## Trả lời trong chat

Mọi câu trả lời trong chat bằng tiếng Việt đều theo skill này, kể cả câu trả lời chỉ vài câu. Hỏi gì trả lời đúng cái đó, vài câu; điều cần nói thêm thì một dòng ở cuối. Người dùng sai thì nói thẳng kèm lý do.
Câu hỏi gửi người dùng phải tự đứng được: ở đâu, hiện thế nào, vì sao hỏi, mỗi phương án ra sao. Báo kết quả chỉ gồm
vấn đề và việc cần làm; không khen, không chấm điểm, không ước lượng thời gian. Câu trong lời trả cũng soát như văn trong
tệp. Người dùng dán mật khẩu, token vào chat thì nói rõ đó là gì và khuyên thu hồi.

## Sửa văn có sẵn

Sửa cấu trúc câu và đoạn trước, thay từ sau; câu đã ổn thì để yên. Giữ nguyên dữ kiện, con số, tên riêng, mức chắc
chắn, giọng tác giả; không thêm chi tiết; không đụng lời trích, code, output. Người dùng chê một câu thì sửa câu đó và
hỏi lý do trước khi áp cho cả bài. Bản cần sửa do agent viết thì đối chiếu với dữ kiện gốc: lời tả không có trong dữ kiện
thì bỏ, tên riêng người dùng không chê thì giữ và hỏi. Không áp skill cho văn bản quy phạm pháp luật, hợp đồng, biểu mẫu,
thơ, lời thoại.

## Trả kết quả

| Việc | Trả gì |
|---|---|
| Viết mới | đường dẫn tuyệt đối của tệp (hay chính văn bản), thêm một hai câu về chỗ chưa kiểm tra hay thiếu dữ kiện |
| Sửa đoạn được dán vào | bản đã sửa, rồi tối đa năm dòng nêu thay đổi chính và lý do |
| Sửa một tệp | chỉ sửa phần văn, báo số chỗ đã sửa theo loại |
| Soát mà không sửa | từng chỗ "câu gốc, vấn đề, cách sửa", từ nặng tới nhẹ |
| Báo cáo lỗi, báo cáo rà soát | theo `references/review-reports.md` |
| Hồ sơ dự thầu | làm đủ quy trình trong `references/bid-proposals.md` |
| Tệp Word | theo `references/docx-export.md`, kèm bản PDF đã xem từng trang |
| Bộ nhớ, học từ phiên cũ | theo `references/agent-memory.md` |

Chi tiết của từng dòng ở `references/core-rules.md`, mục Lời trả theo từng việc.

## Gọi bằng lệnh

Người dùng gõ `/vina-me <việc> <phần còn lại>` thì chữ đầu là tên việc:

| Gõ | Làm |
|---|---|
| `write` | viết mới theo phần còn lại, quy trình ở trên |
| `edit` | sửa văn có sẵn (tệp hay đoạn dán vào), theo mục Sửa văn có sẵn |
| `review` | soát mà không sửa, trả theo dòng Soát mà không sửa |
| `score` | chấm điểm một bài, đọc tuần tự từng câu, trừ theo thang ở `references/scoring.md`, trả điểm và danh sách câu rồi dừng; nhờ agent khác chấm hay sửa rồi chấm lại chỉ làm khi người dùng nói rõ |
| `word` | dựng hay xuất tệp Word và PDF (`references/docx-export.md`; văn bản hành chính thêm `references/official-documents.md`) |
| `bid` | hồ sơ dự thầu từ thư mục gói thầu (`references/bid-proposals.md`) |
| `memory` | dựng, soát, dọn bộ nhớ dùng chung (`references/agent-memory.md`) |
| `secret` | cất mật khẩu cho agent (`references/agent-memory.md`, mục Mật khẩu và token) |
| `feedback` | gửi các dòng trong sổ góp ý thành issue (`references/feedback.md`) |

Chữ đầu không phải một trong các tên trên thì coi cả dòng là một lời nhờ bình thường. Thiếu phần còn lại (gõ `/vina-me
edit` không kèm tệp) thì hỏi một câu cần gì.

## Bộ nhớ cho agent

Skill kèm bộ nhớ dùng chung cho các agent ở `~/agent-memory/`. Nếu ngữ cảnh chưa có bộ nhớ người dùng nào, và máy chưa
có cả `~/agent-memory/AGENTS.md` lẫn `~/agent-memory/.disabled`, thì làm xong việc đang làm rồi hỏi người dùng một lần
có muốn dựng bộ nhớ không. Đồng ý thì làm theo `references/agent-memory.md`; không thì tạo tệp rỗng
`~/agent-memory/.disabled` để lần sau khỏi hỏi. Ngữ cảnh đã có CLAUDE.md hay AGENTS.md riêng của người dùng thì tính là
đã có bộ nhớ. Phiên không xem được thư mục nhà, hay bị dặn không đụng tới nó, thì bỏ bước này. Câu hỏi là một dòng
riêng ở cuối lời trả, không tính vào giới hạn số câu, và nói theo việc người dùng làm (ví dụ "để lần sau tự nạp hồ sơ
giọng"), không nói tên công cụ họ không dùng.

## Góp ý về skill

Trong lúc làm, gặp chỗ skill hướng dẫn sai, thiếu hay script lỗi thì ghi một dòng vào sổ góp ý (`references/feedback.md`,
mục Sổ góp ý trong lúc làm), không cần hỏi. Người dùng chê chính skill thì cũng ghi như thế. Làm xong việc thì hỏi một lần
có muốn gửi các dòng ấy thành issue trên repo vina-me không; đồng ý thì làm theo `references/feedback.md`. Người dùng đã nhờ soạn bản nháp góp ý
thì soạn luôn, không hỏi lại.

## Tệp tham khảo

| Tệp | Đọc khi |
|---|---|
| `references/core-rules.md` | viết hay sửa văn bản dài, soát kỹ: bảy điều bản đầy đủ, trình bày, sửa văn có sẵn |
| `references/machine-tells.md` | soát văn AI slop và văn mẫu |
| `references/examples.md` | cần thấy quy tắc chạy trên câu cụ thể |
| `references/cohesion.md` | văn rời rạc, chọn từ nối |
| `references/function-words.md` | câu thừa "đã được", "các", "của", "việc", văn dịch sát tiếng Anh; chọn phó từ, lượng từ, quan hệ từ, trợ từ, tình thái từ |
| `references/sentences-and-paragraphs.md` | câu ghép, trạng ngữ, đoạn, câu chủ đề |
| `references/common-errors.md` | lỗi câu, lỗi đoạn, lỗi dùng từ |
| `references/punctuation.md` | dấu gạch, ký hiệu, dấu câu |
| `references/word-choice.md` | giải nghĩa thuật ngữ, chọn từ, viết hoa, tên riêng |
| `references/voice.md` | chọn giọng, viết theo giọng một người |
| `references/citations-data-figures.md` | lời trích, nguồn, con số, hình, bảng |
| `references/document-types.md` | giải thích, hướng dẫn, báo cáo, báo cáo sự cố, thư, tin nhắn công việc, thông báo gửi khách, kiến nghị, nghị luận |
| `references/structure.md` | dàn ý, mở bài, triển khai, kết bài |
| `references/storytelling.md` | dẫn dắt người đọc đi một mạch: mở bằng câu của người đọc, câu sau móc vào câu trước, tả trước gọi tên sau |
| `references/teaching.md` | bài giảng, tài liệu dạy học, câu hỏi kiểm tra; soát bằng `references/teaching-checklist.md` |
| `references/review-reports.md` | báo cáo lỗi, báo cáo đối chiếu với tài liệu gốc |
| `references/scoring.md` | chấm điểm một bài, tìm chỗ văn AI slop theo từng câu; nhờ agent khác chấm, sửa rồi chấm lại khi người dùng nhờ |
| `references/diagrams-and-docs.md` | chữ trên sơ đồ, trang trình chiếu, tài liệu gửi khách, báo cáo trạng thái hệ thống |
| `references/official-documents.md` | báo cáo, tờ trình, công văn, kế hoạch, biên bản của cơ quan nhà nước |
| `references/bid-proposals.md` | hồ sơ dự thầu: quy trình, việc cấm; chi tiết từng bước ở `references/bid/` |
| `references/docx-export.md` | xuất tệp Word |
| `references/agent-memory.md` | cài vina-me, bộ nhớ dùng chung, học từ phiên cũ, mật khẩu cho agent |
| `references/feedback.md` | người dùng chê hay góp ý về chính skill, gửi góp ý thành issue |

Các script cần Node 18 trở lên; không có Node thì soát bằng mắt. Script xuất Word tự cài gói `docx` ở lần chạy đầu.

