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
- 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).
- 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).
- Chốt tên gọi cho thứ nhắc nhiều lần, chốt xưng hô theo mục Giọng.
- 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ể.
- 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.
- 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
- 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ể.
- 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.
- Ý 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ữ.
- 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à".
- 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).
- 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).
- 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.
1---2name: vina-me3description: "Viết và sửa văn tiếng Việt cho lưu loát, dễ hiểu, không thành văn AI slop, và dựng phần kỹ thuật của hồ sơ dự thầu (E-HSDT). Dùng mỗi khi viết hay sửa tiếng Việt, kể cả khi người dùng không nhắc tới giọng văn: mọi câu trả lời trong chat dù chỉ vài câu, bài giảng, tài liệu, README, báo cáo, văn bản hành chính theo Nghị định 30/2020, email, tin nhắn công việc, chữ trên sơ đồ, tệp Word. Dùng ngay khi người dùng chê văn \"đọc là biết AI viết\", \"máy móc\", \"rời rạc\", \"văn mẫu\", \"AI slop\", hoặc nhờ humanize, viết theo giọng một người. Dùng cho đấu thầu khi người dùng đưa hồ sơ mời thầu (E-HSMT, HSMT, thư mục gói thầu) hay nhờ làm thầu, làm hồ sơ dự thầu, bảng đáp ứng yêu cầu kỹ thuật, thuyết minh đề xuất kỹ thuật, tài liệu hãng tô vàng kèm bản dịch; không dùng để soạn hồ sơ mời thầu cho bên mời thầu. Kèm script cài skill, bộ nhớ dùng chung cho Claude Code và Codex, học từ phiên cũ, giữ mật khẩu cho agent."4license: MIT5argument-hint: "[write|edit|review|score|word|bid|memory|secret|feedback] <yêu cầu, tệp hay thư mục>"6metadata:7 source: https://skillmd.com/skills/anhtuan2111/vina-me8 author: AnhTuan21119 language: vi10 version: "0.21.0"11---1213# Viết cho lưu loát1415Vă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ố16chữ í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;17dùng một lần đúng chỗ thì được, dùng thành thói quen thì thành văn AI slop.1819**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ả20lờ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à21không bỏ qua với lý do đây chỉ là một dòng ngắn.2223## Quy trình24251. 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`).262. 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`).273. Chốt tên gọi cho thứ nhắc nhiều lần, chốt xưng hô theo mục Giọng.284. 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ần29 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ớ30 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ể.315. 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ột32 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ính33 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ó34 điểm thì chấm theo `references/scoring.md`.356. 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.3637## Bảy điều cốt lõi38391. 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ừ,40 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ể.412. 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,42 đó", 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ình43 được thì hai câu đang rời nhau.443. Ý 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ông45 đều; không rút câu cho vừa một mốc số chữ.464. 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à47 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à".485. 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 Anh49 thì giữ nguyên, không dịch (option, không "cờ") (`references/word-choice.md`).506. 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ặc51 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`).527. 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ông53 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",54 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.5556## Dấu gạch và ký hiệu5758Khô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 hay59ngoặ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,60`~`, `&`, `=`; không in hoa cả chữ để nhấn. Bảng thay thế ở `references/punctuation.md`.6162## Giọng6364| Văn bản | Xưng hô và giọng |65|---|---|66| 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 |67| 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 |68| 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ô |69| 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ô |70| 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`) |7172Chi 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ười73cụ thể thì tra `references/voice.md`.7475## Trả lời trong chat7677Mọ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.78Câ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ồm79vấ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 trong80tệ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.8182## Sửa văn có sẵn8384Sử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ắc85chắ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à86hỏ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ện87thì 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,88thơ, lời thoại.8990## Trả kết quả9192| Việc | Trả gì |93|---|---|94| 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 |95| 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 |96| Sửa một tệp | chỉ sửa phần văn, báo số chỗ đã sửa theo loại |97| 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ẹ |98| Báo cáo lỗi, báo cáo rà soát | theo `references/review-reports.md` |99| Hồ sơ dự thầu | làm đủ quy trình trong `references/bid-proposals.md` |100| Tệp Word | theo `references/docx-export.md`, kèm bản PDF đã xem từng trang |101| Bộ nhớ, học từ phiên cũ | theo `references/agent-memory.md` |102103Chi tiết của từng dòng ở `references/core-rules.md`, mục Lời trả theo từng việc.104105## Gọi bằng lệnh106107Người dùng gõ `/vina-me <việc> <phần còn lại>` thì chữ đầu là tên việc:108109| Gõ | Làm |110|---|---|111| `write` | viết mới theo phần còn lại, quy trình ở trên |112| `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 |113| `review` | soát mà không sửa, trả theo dòng Soát mà không sửa |114| `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õ |115| `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`) |116| `bid` | hồ sơ dự thầu từ thư mục gói thầu (`references/bid-proposals.md`) |117| `memory` | dựng, soát, dọn bộ nhớ dùng chung (`references/agent-memory.md`) |118| `secret` | cất mật khẩu cho agent (`references/agent-memory.md`, mục Mật khẩu và token) |119| `feedback` | gửi các dòng trong sổ góp ý thành issue (`references/feedback.md`) |120121Chữ đầ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-me122edit` không kèm tệp) thì hỏi một câu cần gì.123124## Bộ nhớ cho agent125126Skill 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ưa127có 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ần128có 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ỗng129`~/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à130đã 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òng131riê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ơ132giọng"), không nói tên công cụ họ không dùng.133134## Góp ý về skill135136Trong 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`,137mụ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ần138có 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 ý139thì soạn luôn, không hỏi lại.140141## Tệp tham khảo142143| Tệp | Đọc khi |144|---|---|145| `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 |146| `references/machine-tells.md` | soát văn AI slop và văn mẫu |147| `references/examples.md` | cần thấy quy tắc chạy trên câu cụ thể |148| `references/cohesion.md` | văn rời rạc, chọn từ nối |149| `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ừ |150| `references/sentences-and-paragraphs.md` | câu ghép, trạng ngữ, đoạn, câu chủ đề |151| `references/common-errors.md` | lỗi câu, lỗi đoạn, lỗi dùng từ |152| `references/punctuation.md` | dấu gạch, ký hiệu, dấu câu |153| `references/word-choice.md` | giải nghĩa thuật ngữ, chọn từ, viết hoa, tên riêng |154| `references/voice.md` | chọn giọng, viết theo giọng một người |155| `references/citations-data-figures.md` | lời trích, nguồn, con số, hình, bảng |156| `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 |157| `references/structure.md` | dàn ý, mở bài, triển khai, kết bài |158| `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 |159| `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` |160| `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 |161| `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ờ |162| `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 |163| `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 |164| `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/` |165| `references/docx-export.md` | xuất tệp Word |166| `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 |167| `references/feedback.md` | người dùng chê hay góp ý về chính skill, gửi góp ý thành issue |168169Cá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.