[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75BS6G0TYQYVQV0MBQW6MB8":3,"skill-same:01M75BS6G0TYQYVQV0MBQW6MB8":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75BS6G0TYQYVQV0MBQW6MB8","vietnamese-technical-writing",null,"Use when drafting, reviewing, or rewriting Vietnamese prose in this Coppice repository — README.vi.md, Vietnamese website docs, and Vietnamese UI strings. On a style pass, leave commands, keys, URLs, permissions, and locked positioning unchanged. Not for other languages, product behavior, or end-user agent skills.","fertile-org\u002Fcoppice","fertile-org","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F227551241?v=4","01M75BR3ZY4ZPYV3K2HN0BFNG0","01M75BR40HADBDTJAGZKFHRJPH",25,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fvietnamese-technical-writing\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: vietnamese-technical-writing\ndescription: Use when drafting, reviewing, or rewriting Vietnamese prose in this Coppice repository — README.vi.md, Vietnamese website docs, and Vietnamese UI strings. On a style pass, leave commands, keys, URLs, permissions, and locked positioning unchanged. Not for other languages, product behavior, or end-user agent skills.\n---\n\n# Viết kỹ thuật tiếng Việt trong Coppice\n\n## Phạm vi và nguyên tắc\n\nDùng cho nội dung tiếng Việt được giao biên soạn trong repo Coppice: hướng dẫn, README, giải thích, tài liệu tra cứu và lời giao diện. Đây là hướng dẫn tác giả **cục bộ trong repo**, không thay skill tiếng Anh, không phải thành phần sản phẩm chạy lúc thực thi, plugin marketplace hay skill toàn cục. Hướng dẫn không tự cấp quyền sửa, cài đặt hoặc xuất bản nội dung.\n\nMục tiêu là giúp người đọc hiểu đúng và làm đúng, không phải bắt chước một blogger, giả trải nghiệm cá nhân hay qua mặt bộ nhận diện AI. Không cố tình thêm lỗi, tiếng lóng hoặc câu vụng để có vẻ \"do người viết\".\n\nCơ sở: người rà soát đọc toàn bộ phần văn bản chính của 31 bài ứng viên, rồi giữ 30 bài có ngày xuất bản đầu tiên trước 2020-11-07, từ 7 nơi xuất bản và 8 danh tính được ghi công; phần lớn là bài giải thích\u002Fhướng dẫn trên blog. E03 bị loại vì lời giải thích bám bản dịch\u002Fchuyển thể tiếng Anh; N02 thay E03. Chỉ 30 bài được giữ mới được tính. E03 không phải căn cứ quy tắc, và không tính cả hai. Xem [repo-references.md](repo-references.md), [repo-reference-manifest.json](repo-reference-manifest.json) và [review-evidence.md](review-evidence.md). Đây không phải thống kê về mọi người viết tiếng Việt hay xác nhận tiếng mẹ đẻ của tác giả. E05 chỉ có bằng chứng về nơi xuất bản đã được biết đến, chưa xác nhận mức độ nổi tiếng riêng của người viết. Văn bản đang trực tuyến có thể đã được sửa sau ngày xuất bản; không phải mọi câu hiện tại đều được chứng minh là có trước 2020. Không dùng các bài cũ để suy ra chức năng Coppice hoặc lệnh hiện hành.\n\nCác lựa chọn ngôn ngữ dưới đây được minh họa trong nguồn. Bố cục riêng cho README\u002FUI, giọng sản phẩm, giữ nguyên chuỗi kỹ thuật và đặt cảnh báo sát thao tác là **quy ước biên tập\u002Fan toàn của tài liệu**, không phải kết luận rằng cả 30 tác giả đều làm như vậy.\n\n## Nơi áp dụng\n\nDùng skill này khi sửa tiếng Việt trong repo này:\n\n- [README.vi.md](..\u002F..\u002F..\u002FREADME.vi.md)\n- Tài liệu tiếng Việt trong [website\u002Fsrc\u002Fcontent\u002Fdocs\u002Fvi\u002F](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fcontent\u002Fdocs\u002Fvi\u002F)\n- Chuỗi giao diện tiếng Việt trong [website\u002Fsrc\u002Fi18n\u002Fpages\u002Fvi.ts](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fi18n\u002Fpages\u002Fvi.ts) và [website\u002Fsrc\u002Fi18n\u002Fui\u002Fvi.ts](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fi18n\u002Fui\u002Fvi.ts)\n\nSkill nằm ở `.agents\u002Fskills\u002Fvietnamese-technical-writing\u002F`. `.claude\u002Fskills` trỏ tới cùng thư mục, nên agent nào làm việc trong repo này cũng nạp được. Không chép sang thư mục `skills\u002F` ở gốc repo, `server\u002Fbuiltin-plugins\u002F` hay `server\u002Fmarketplace\u002F`. Đó là layout skill mà server có thể đưa vào agent của người dùng cuối.\n\nSkill tiếng Anh là [english-technical-writing](..\u002Fenglish-technical-writing\u002FSKILL.md). Không áp thói quen tiếng Anh sang tiếng Việt, và không dùng skill này để sửa văn tiếng Anh. Tiếng Trung giản thể có skill riêng: [zh-cn-technical-writing](..\u002Fzh-cn-technical-writing\u002FSKILL.md). Tiếng Trung phồn thể Đài Loan có skill riêng: [zh-tw-technical-writing](..\u002Fzh-tw-technical-writing\u002FSKILL.md). Tiếng Trung phồn thể Hồng Kông có skill riêng: [zh-hk-technical-writing](..\u002Fzh-hk-technical-writing\u002FSKILL.md). Tiếng Nhật có skill riêng: [ja-technical-writing](..\u002Fja-technical-writing\u002FSKILL.md). Tiếng Pháp có skill riêng: [fr-technical-writing](..\u002Ffr-technical-writing\u002FSKILL.md). Các ngôn ngữ khác vẫn chờ vòng nghiên cứu riêng; không phác chúng từ skill này.\n\nKhi chỉ sửa văn phong, giữ nguyên định vị đã khóa trong [docs\u002Fmilestones\u002FM12-beta-release.md](..\u002F..\u002F..\u002Fdocs\u002Fmilestones\u002FM12-beta-release.md) và [docs\u002Fweb\u002FDESIGN.md](..\u002F..\u002F..\u002Fdocs\u002Fweb\u002FDESIGN.md), nhãn Beta, cùng tên cổng **Plan Review** và **Wait for Human Review**.\n\n## Trước khi sửa\n\n1. Xác định người đọc, loại văn bản và việc họ cần hiểu\u002Flàm. Đọc thuật ngữ và quy ước đang có trong repo; ưu tiên chúng hơn sở thích cá nhân.\n2. Ghi lại điều không được đổi: ai làm gì, đối tượng nào, điều kiện\u002Fphạm vi, thứ tự, số lượng, phủ định, mức chắc chắn, quyền hạn và cảnh báo. Phân biệt sự thật đã được cung cấp với chỗ chưa biết.\n3. Giữ nguyên các tên và chuỗi kỹ thuật cần khớp chính xác (literal): API, tên biến, khóa cấu hình, đường dẫn, lệnh, cờ, số phiên bản, mã lỗi và nhãn giao diện được trích dẫn. Chỉ sửa kỹ thuật khi nhiệm vụ cho phép và có căn cứ. Phát hiện lệnh có vẻ sai\u002Fnguy hiểm thì báo riêng, không đoán cách sửa rồi coi đó là sửa văn phong.\n\n## Mười hai quy tắc\n\n### 1. Cho người đọc biết mục đích và phạm vi đủ sớm\n\nNói rõ đoạn này giúp làm gì và cần biết\u002Fcó gì trước đó. Với một thao tác, nêu điều kiện liên quan trước bước cần dùng. Bài giải thích có thể mở bằng tình huống nếu nó thực sự giúp hiểu vấn đề; không ép mọi bài thành câu trả lời cụt ngay đầu. [H01, H04, M03; đối chiếu phần dẫn M02, T02]\n\n### 2. Để người đọc nhận ra ai làm gì\n\nGọi đúng thành phần khi chúng có vai trò khác nhau: người dùng chọn, máy chủ kiểm tra, worker xử lý. Khi đổi tác nhân, nhắc lại tên thay vì nối nhiều \"nó\".\n\nCâu có chủ đề như \"Với bộ nhớ đệm này, …\", \"Riêng bước nhập dữ liệu, …\" là tự nhiên nếu phần sau rõ nghĩa. Không bắt mọi vế lặp một chủ ngữ. Dùng bị\u002Fđược khi đối tượng chịu tác động đáng chú ý hơn hoặc tác nhân chưa được xác định; đừng tự bổ sung tác nhân để biến câu bị động thành chủ động. [H03, G02, T05]\n\n### 3. Giữ đúng điều kiện, kết quả và mức khẳng định\n\nNối rõ \"nếu\u002Fkhi… thì…\", \"chỉ… khi…\", \"trước\u002Fsau…\". Không biến điều kiện đủ thành điều kiện cần, hoặc ngược lại. Giữ phạm vi hệ điều hành, phiên bản, quyền và môi trường ở đúng kết luận mà chúng giới hạn. [E02, E04, M01]\n\n**Bất biến khi sửa:** phải ≠ nên ≠ có thể; không ≠ chưa; không bảo đảm ≠ chắc chắn có lần thất bại. \"Có thể nhanh hơn\" không thành \"sẽ nhanh hơn\". Không bỏ sẽ\u002Fđã\u002Fđang\u002Fchưa chỉ để rút gọn nếu chúng mang thông tin thời gian\u002Ftrạng thái.\n\n### 4. Chọn quan hệ xưng hô có chủ đích\n\nTài liệu sản phẩm thường có thể viết trung tính; dùng \"bạn\" khi cần chỉ rõ người đọc. Không mở mọi bước bằng \"Bạn hãy…\". Trong bài có tác giả thực sự, tôi\u002Fmình có thể phù hợp; không áp đặt mình là cách xưng hô duy nhất tự nhiên. [M01, M02, C03, N01]\n\nGiữ vai người nói và người nghe nhất quán theo ngữ cảnh, không đếm số lần đổi đại từ. Không bịa \"mình đã thử\", \"đội ngũ chúng tôi thường…\" hay kinh nghiệm của người được trích dẫn.\n\n### 5. Lược phần đã rõ, không lược trách nhiệm\n\nCó thể viết \"Chạy `git status`, rồi đọc danh sách tệp đã thay đổi\" khi cả hai việc đều do người đọc làm. Nếu bước sau do máy chủ hoặc tiến trình khác thực hiện, nêu lại tác nhân. Không bỏ tên đối tượng trong cảnh báo có thể bị tách ra khỏi đoạn. [E02, G03, T01]\n\n### 6. Chia theo tải thông tin, không theo số từ\n\nMột bước chỉ dẫn nên dễ theo dõi. Một câu giải thích vẫn có thể dài nếu điều kiện và lập luận cần đi cùng nhau. Tách khi người đọc phải giữ quá nhiều đối tượng hoặc phạm vi; không tách làm rơi \"nếu\", \"chỉ\", \"trên Linux\" hay nguyên nhân của kết quả. [M01, H06, N01]\n\nKhông đặt trần độ dài bằng cách đếm khoảng trắng: khoảng trắng tiếng Việt còn phân tách âm tiết. Đọc lại thành lời để nghe nhịp; không vì muốn câu ngắn mà cắt mất nội dung.\n\n### 7. Dùng từ nối đúng quan hệ\n\nDùng \"nhưng\u002Ftuy nhiên\" khi có đối lập, \"vì\u002Fdo đó\u002Fnên\" khi có nguyên nhân hoặc suy ra, \"trong khi\" khi so sánh. Nếu chưa có quan hệ ấy, đừng thêm từ nối cho trơn. \"Và\", \"Vậy\" đầu câu không tự động là lỗi; \"Tuy nhiên\" cũng không phải dấu hiệu văn máy. [H01, E05, M02]\n\n### 8. Lặp đúng thuật ngữ thay vì đổi tên cho đẹp\n\nKết quả không nhất thiết là giá trị trả về; bộ nhớ đệm không phải dữ liệu được lưu trong nó; Promise không phải mảng chứa Promise. Dùng cùng tên cho cùng khái niệm. Có thể dùng đại từ hoặc cách gọi tương đương sau khi đã xác định rõ, nhưng không đổi danh từ khi điều đó làm mờ tham chiếu. [H03, G02, T03]\n\n### 9. Chọn động từ rõ; giải thích thuật ngữ cần thiết\n\nƯu tiên \"cài\", \"kiểm tra\", \"lưu\" hơn \"thực hiện việc cài đặt\u002Fkiểm tra\u002Flưu\" khi nghĩa không đổi. Không cấm mọi việc\u002Fsự hoặc từ Hán–Việt: cách diễn đạt phải hợp nghĩa và quy ước lĩnh vực. [T01, T03]\n\nVới thuật ngữ khó dịch, dùng thuật ngữ dự án đã chọn; có thể chú thích tên tiếng Anh ở lần đầu để tra cứu. Nếu chưa có cách dịch ổn định, giữ tên tiếng Anh và giải thích vai trò bằng tiếng Việt, đừng ép dịch từng chữ. Không loại thuật ngữ đã được chấp nhận chỉ vì một tác giả không thích nó. [M03; quan điểm riêng ở M04 không phải chuẩn thuật ngữ]\n\n### 10. Giữ nguyên tên và chuỗi kỹ thuật; giải thích vai trò\n\nKhông đổi tên API, chuỗi ký tự, lệnh hoặc cấu hình để câu \"thuần Việt\". Giải thích đầu vào, đầu ra, tác dụng và giới hạn bằng lời quanh chúng. Ví dụ cũ có thể sai; dẫn nguồn không thay thế kiểm tra kỹ thuật. [E02, E05, T05]\n\nNếu nhiệm vụ chỉ sửa văn phong, nhãn UI\u002Fthông báo được trích dẫn phải khớp sản phẩm. Nếu được giao sửa chính lời UI, nhãn đó là nội dung có thể sửa: cập nhật các chỗ tham chiếu tương ứng và vẫn giữ mã\u002Fđịnh danh không thuộc phạm vi sửa.\n\n### 11. Cho ví dụ đủ nhỏ và nói rõ nó chứng minh điều gì\n\nKhi cần, đưa đầu vào\u002Fthao tác, kết quả dự kiến và lời giải thích. Phân biệt kết quả quan sát ở một ví dụ với bảo đảm chung; tách lời quảng cáo được dẫn lại khỏi nhận xét hay kết quả của tác giả. Nếu đề bài không cung cấp hành vi sản phẩm, ghi giả định hoặc hỏi lại thay vì bịa ví dụ như một tính năng thật. [H02, E05, M02, N02]\n\nVí dụ lỗi có chủ đích trong bài dạy kiểm thử được phép nếu ghi rõ mục đích và kết quả mong đợi. Điều đó khác với cố tình thêm lỗi văn bản hoặc lỗi lệnh để giả phong cách con người.\n\n### 12. Giữ giọng bình tĩnh, giới hạn và cảnh báo\n\nKhông cần sao chép chuyện đùa, tục ngữ chế, giọng quảng cáo hay phán đoán tuyệt đối của blog. Nêu đánh đổi và điều chưa kiểm chứng. Đừng làm một câu cảnh báo \"nhẹ nhàng hơn\" bằng cách giảm mức nguy hiểm hoặc bỏ trách nhiệm. [C04, H01, H05, M01]\n\nTheo quy ước an toàn, đặt cảnh báo trước\u002Fsát thao tác có hậu quả; đây là lựa chọn biên tập, dù nhiều nguồn để hạn chế ở cuối bài. Mất kết nối không chứng minh yêu cầu chưa được lưu; chỉ hướng dẫn thử lại khi đã có căn cứ cho thấy làm vậy an toàn.\n\n## Áp dụng theo loại văn bản\n\nĐây là cách chuyển các nguyên tắc vào Coppice, không phải các thể loại đã được khảo sát đại diện:\n\n- **README:** cho biết mục đích, đối tượng, điều kiện chạy và các bước tối thiểu để dùng thử; dẫn tới giải thích dài hơn. Không thêm lời hứa hiệu năng.\n- **Hướng dẫn:** điều kiện → bước → kết quả kiểm tra; gọi rõ thành phần ở mỗi lần đổi tác nhân; cảnh báo trước bước gây tác động.\n- **Tra cứu:** dễ quét; tên chính xác, kiểu\u002Fgiá trị mặc định\u002Fphạm vi chỉ ghi khi có dữ kiện; không hy sinh điều kiện để ép mỗi mục thành một câu.\n- **Trang giới thiệu:** nói rõ ích lợi và giới hạn có căn cứ; không lấy lời khen chung thay cho hành vi cụ thể.\n- **UI\u002Flỗi:** ngắn nhưng giữ trạng thái biết\u002Fchưa biết, đối tượng và mức nghiêm trọng. Chỉ nêu hành động khôi phục đã được xác nhận an toàn.\n\n## Ví dụ biên tập tổng hợp\n\nĐây là các dữ kiện giả định dùng để thử cách biên tập, **không mô tả tính năng Coppice**.\n\n- Cho biết: ứng dụng sẽ chỉ lưu `config.json` khi người dùng bấm nhãn \"Lưu\". Viết: \"Ứng dụng sẽ chỉ lưu tệp `config.json` khi bạn bấm Lưu.\" Giữ sẽ, chỉ, điều kiện và nhãn.\n- Cho biết: trên Linux có thể khởi động nhanh hơn, phụ thuộc dữ liệu, không có bảo đảm cho mọi lần chạy. Viết: \"Trên Linux, tính năng này có thể giảm thời gian khởi động. Tuy nhiên, kết quả trên Linux còn phụ thuộc vào dữ liệu nên không có bảo đảm rằng lần chạy nào cũng nhanh hơn.\" **Không** đổi thành \"không phải lần chạy nào cũng nhanh hơn\": câu đó khẳng định đã có ngoại lệ.\n- Cho biết: kết nối thất bại; người nói không biết chắc yêu cầu đã được lưu. Viết: \"Không kết nối được. Chúng tôi không biết chắc yêu cầu đã được lưu hay chưa.\" Không đổi thành chưa lưu hoặc thêm lời mời thử lại.\n- Cho biết: tệp trong `out\u002F` sẽ bị ghi đè khi xuất; phải sao lưu tệp cần giữ trước đó. Viết: \"Các tệp hiện có trong `out\u002F` sẽ bị ghi đè khi xuất dữ liệu. Phải sao lưu các tệp cần giữ trước khi xuất.\" Câu bị động ở đây giữ đúng điều chưa xác định về tác nhân.\n\n## Rà soát trước khi giao\n\n- So từng ý trước\u002Fsau: cùng tác nhân, đối tượng, chuỗi kỹ thuật, số lượng, phạm vi và thứ tự?\n- Còn nguyên chỉ\u002Fmọi\u002Fít nhất, phủ định, trạng thái, phải\u002Fnên\u002Fcó thể và điều chưa biết?\n- Có chỗ lược chủ ngữ khiến không rõ ai làm? Có đổi thuật ngữ khiến tưởng là khái niệm khác?\n- Có thêm tính năng, quan hệ nhân quả, hiệu năng, bảo đảm an toàn hoặc bước khôi phục không có căn cứ?\n- Đọc thành lời: nhịp có tự nhiên, câu dài có cần thiết, câu ngắn có làm đứt điều kiện không?\n- Nếu mâu thuẫn kỹ thuật chưa giải quyết được, ghi rõ để người phụ trách kiểm tra. Không che nó bằng câu văn trôi chảy.\n","# Viết kỹ thuật tiếng Việt trong Coppice\n\n## Phạm vi và nguyên tắc\n\nDùng cho nội dung tiếng Việt được giao biên soạn trong repo Coppice: hướng dẫn, README, giải thích, tài liệu tra cứu và lời giao diện. Đây là hướng dẫn tác giả **cục bộ trong repo**, không thay skill tiếng Anh, không phải thành phần sản phẩm chạy lúc thực thi, plugin marketplace hay skill toàn cục. Hướng dẫn không tự cấp quyền sửa, cài đặt hoặc xuất bản nội dung.\n\nMục tiêu là giúp người đọc hiểu đúng và làm đúng, không phải bắt chước một blogger, giả trải nghiệm cá nhân hay qua mặt bộ nhận diện AI. Không cố tình thêm lỗi, tiếng lóng hoặc câu vụng để có vẻ \"do người viết\".\n\nCơ sở: người rà soát đọc toàn bộ phần văn bản chính của 31 bài ứng viên, rồi giữ 30 bài có ngày xuất bản đầu tiên trước 2020-11-07, từ 7 nơi xuất bản và 8 danh tính được ghi công; phần lớn là bài giải thích\u002Fhướng dẫn trên blog. E03 bị loại vì lời giải thích bám bản dịch\u002Fchuyển thể tiếng Anh; N02 thay E03. Chỉ 30 bài được giữ mới được tính. E03 không phải căn cứ quy tắc, và không tính cả hai. Xem [repo-references.md](repo-references.md), [repo-reference-manifest.json](repo-reference-manifest.json) và [review-evidence.md](review-evidence.md). Đây không phải thống kê về mọi người viết tiếng Việt hay xác nhận tiếng mẹ đẻ của tác giả. E05 chỉ có bằng chứng về nơi xuất bản đã được biết đến, chưa xác nhận mức độ nổi tiếng riêng của người viết. Văn bản đang trực tuyến có thể đã được sửa sau ngày xuất bản; không phải mọi câu hiện tại đều được chứng minh là có trước 2020. Không dùng các bài cũ để suy ra chức năng Coppice hoặc lệnh hiện hành.\n\nCác lựa chọn ngôn ngữ dưới đây được minh họa trong nguồn. Bố cục riêng cho README\u002FUI, giọng sản phẩm, giữ nguyên chuỗi kỹ thuật và đặt cảnh báo sát thao tác là **quy ước biên tập\u002Fan toàn của tài liệu**, không phải kết luận rằng cả 30 tác giả đều làm như vậy.\n\n## Nơi áp dụng\n\nDùng skill này khi sửa tiếng Việt trong repo này:\n\n- [README.vi.md](..\u002F..\u002F..\u002FREADME.vi.md)\n- Tài liệu tiếng Việt trong [website\u002Fsrc\u002Fcontent\u002Fdocs\u002Fvi\u002F](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fcontent\u002Fdocs\u002Fvi\u002F)\n- Chuỗi giao diện tiếng Việt trong [website\u002Fsrc\u002Fi18n\u002Fpages\u002Fvi.ts](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fi18n\u002Fpages\u002Fvi.ts) và [website\u002Fsrc\u002Fi18n\u002Fui\u002Fvi.ts](..\u002F..\u002F..\u002Fwebsite\u002Fsrc\u002Fi18n\u002Fui\u002Fvi.ts)\n\nSkill nằm ở `.agents\u002Fskills\u002Fvietnamese-technical-writing\u002F`. `.claude\u002Fskills` trỏ tới cùng thư mục, nên agent nào làm việc trong repo này cũng nạp được. Không chép sang thư mục `skills\u002F` ở gốc repo, `server\u002Fbuiltin-plugins\u002F` hay `server\u002Fmarketplace\u002F`. Đó là layout skill mà server có thể đưa vào agent của người dùng cuối.\n\nSkill tiếng Anh là [english-technical-writing](..\u002Fenglish-technical-writing\u002FSKILL.md). Không áp thói quen tiếng Anh sang tiếng Việt, và không dùng skill này để sửa văn tiếng Anh. Tiếng Trung giản thể có skill riêng: [zh-cn-technical-writing](..\u002Fzh-cn-technical-writing\u002FSKILL.md). Tiếng Trung phồn thể Đài Loan có skill riêng: [zh-tw-technical-writing](..\u002Fzh-tw-technical-writing\u002FSKILL.md). Tiếng Trung phồn thể Hồng Kông có skill riêng: [zh-hk-technical-writing](..\u002Fzh-hk-technical-writing\u002FSKILL.md). Tiếng Nhật có skill riêng: [ja-technical-writing](..\u002Fja-technical-writing\u002FSKILL.md). Tiếng Pháp có skill riêng: [fr-technical-writing](..\u002Ffr-technical-writing\u002FSKILL.md). Các ngôn ngữ khác vẫn chờ vòng nghiên cứu riêng; không phác chúng từ skill này.\n\nKhi chỉ sửa văn phong, giữ nguyên định vị đã khóa trong [docs\u002Fmilestones\u002FM12-beta-release.md](..\u002F..\u002F..\u002Fdocs\u002Fmilestones\u002FM12-beta-release.md) và [docs\u002Fweb\u002FDESIGN.md](..\u002F..\u002F..\u002Fdocs\u002Fweb\u002FDESIGN.md), nhãn Beta, cùng tên cổng **Plan Review** và **Wait for Human Review**.\n\n## Trước khi sửa\n\n1. Xác định người đọc, loại văn bản và việc họ cần hiểu\u002Flàm. Đọc thuật ngữ và quy ước đang có trong repo; ưu tiên chúng hơn sở thích cá nhân.\n2. Ghi lại điều không được đổi: ai làm gì, đối tượng nào, điều kiện\u002Fphạm vi, thứ tự, số lượng, phủ định, mức chắc chắn, quyền hạn và cảnh báo. Phân biệt sự thật đã được cung cấp với chỗ chưa biết.\n3. Giữ nguyên các tên và chuỗi kỹ thuật cần khớp chính xác (literal): API, tên biến, khóa cấu hình, đường dẫn, lệnh, cờ, số phiên bản, mã lỗi và nhãn giao diện được trích dẫn. Chỉ sửa kỹ thuật khi nhiệm vụ cho phép và có căn cứ. Phát hiện lệnh có vẻ sai\u002Fnguy hiểm thì báo riêng, không đoán cách sửa rồi coi đó là sửa văn phong.\n\n## Mười hai quy tắc\n\n### 1. Cho người đọc biết mục đích và phạm vi đủ sớm\n\nNói rõ đoạn này giúp làm gì và cần biết\u002Fcó gì trước đó. Với một thao tác, nêu điều kiện liên quan trước bước cần dùng. Bài giải thích có thể mở bằng tình huống nếu nó thực sự giúp hiểu vấn đề; không ép mọi bài thành câu trả lời cụt ngay đầu. [H01, H04, M03; đối chiếu phần dẫn M02, T02]\n\n### 2. Để người đọc nhận ra ai làm gì\n\nGọi đúng thành phần khi chúng có vai trò khác nhau: người dùng chọn, máy chủ kiểm tra, worker xử lý. Khi đổi tác nhân, nhắc lại tên thay vì nối nhiều \"nó\".\n\nCâu có chủ đề như \"Với bộ nhớ đệm này, …\", \"Riêng bước nhập dữ liệu, …\" là tự nhiên nếu phần sau rõ nghĩa. Không bắt mọi vế lặp một chủ ngữ. Dùng bị\u002Fđược khi đối tượng chịu tác động đáng chú ý hơn hoặc tác nhân chưa được xác định; đừng tự bổ sung tác nhân để biến câu bị động thành chủ động. [H03, G02, T05]\n\n### 3. Giữ đúng điều kiện, kết quả và mức khẳng định\n\nNối rõ \"nếu\u002Fkhi… thì…\", \"chỉ… khi…\", \"trước\u002Fsau…\". Không biến điều kiện đủ thành điều kiện cần, hoặc ngược lại. Giữ phạm vi hệ điều hành, phiên bản, quyền và môi trường ở đúng kết luận mà chúng giới hạn. [E02, E04, M01]\n\n**Bất biến khi sửa:** phải ≠ nên ≠ có thể; không ≠ chưa; không bảo đảm ≠ chắc chắn có lần thất bại. \"Có thể nhanh hơn\" không thành \"sẽ nhanh hơn\". Không bỏ sẽ\u002Fđã\u002Fđang\u002Fchưa chỉ để rút gọn nếu chúng mang thông tin thời gian\u002Ftrạng thái.\n\n### 4. Chọn quan hệ xưng hô có chủ đích\n\nTài liệu sản phẩm thường có thể viết trung tính; dùng \"bạn\" khi cần chỉ rõ người đọc. Không mở mọi bước bằng \"Bạn hãy…\". Trong bài có tác giả thực sự, tôi\u002Fmình có thể phù hợp; không áp đặt mình là cách xưng hô duy nhất tự nhiên. [M01, M02, C03, N01]\n\nGiữ vai người nói và người nghe nhất quán theo ngữ cảnh, không đếm số lần đổi đại từ. Không bịa \"mình đã thử\", \"đội ngũ chúng tôi thường…\" hay kinh nghiệm của người được trích dẫn.\n\n### 5. Lược phần đã rõ, không lược trách nhiệm\n\nCó thể viết \"Chạy `git status`, rồi đọc danh sách tệp đã thay đổi\" khi cả hai việc đều do người đọc làm. Nếu bước sau do máy chủ hoặc tiến trình khác thực hiện, nêu lại tác nhân. Không bỏ tên đối tượng trong cảnh báo có thể bị tách ra khỏi đoạn. [E02, G03, T01]\n\n### 6. Chia theo tải thông tin, không theo số từ\n\nMột bước chỉ dẫn nên dễ theo dõi. Một câu giải thích vẫn có thể dài nếu điều kiện và lập luận cần đi cùng nhau. Tách khi người đọc phải giữ quá nhiều đối tượng hoặc phạm vi; không tách làm rơi \"nếu\", \"chỉ\", \"trên Linux\" hay nguyên nhân của kết quả. [M01, H06, N01]\n\nKhông đặt trần độ dài bằng cách đếm khoảng trắng: khoảng trắng tiếng Việt còn phân tách âm tiết. Đọc lại thành lời để nghe nhịp; không vì muốn câu ngắn mà cắt mất nội dung.\n\n### 7. Dùng từ nối đúng quan hệ\n\nDùng \"nhưng\u002Ftuy nhiên\" khi có đối lập, \"vì\u002Fdo đó\u002Fnên\" khi có nguyên nhân hoặc suy ra, \"trong khi\" khi so sánh. Nếu chưa có quan hệ ấy, đừng thêm từ nối cho trơn. \"Và\", \"Vậy\" đầu câu không tự động là lỗi; \"Tuy nhiên\" cũng không phải dấu hiệu văn máy. [H01, E05, M02]\n\n### 8. Lặp đúng thuật ngữ thay vì đổi tên cho đẹp\n\nKết quả không nhất thiết là giá trị trả về; bộ nhớ đệm không phải dữ liệu được lưu trong nó; Promise không phải mảng chứa Promise. Dùng cùng tên cho cùng khái niệm. Có thể dùng đại từ hoặc cách gọi tương đương sau khi đã xác định rõ, nhưng không đổi danh từ khi điều đó làm mờ tham chiếu. [H03, G02, T03]\n\n### 9. Chọn động từ rõ; giải thích thuật ngữ cần thiết\n\nƯu tiên \"cài\", \"kiểm tra\", \"lưu\" hơn \"thực hiện việc cài đặt\u002Fkiểm tra\u002Flưu\" khi nghĩa không đổi. Không cấm mọi việc\u002Fsự hoặc từ Hán–Việt: cách diễn đạt phải hợp nghĩa và quy ước lĩnh vực. [T01, T03]\n\nVới thuật ngữ khó dịch, dùng thuật ngữ dự án đã chọn; có thể chú thích tên tiếng Anh ở lần đầu để tra cứu. Nếu chưa có cách dịch ổn định, giữ tên tiếng Anh và giải thích vai trò bằng tiếng Việt, đừng ép dịch từng chữ. Không loại thuật ngữ đã được chấp nhận chỉ vì một tác giả không thích nó. [M03; quan điểm riêng ở M04 không phải chuẩn thuật ngữ]\n\n### 10. Giữ nguyên tên và chuỗi kỹ thuật; giải thích vai trò\n\nKhông đổi tên API, chuỗi ký tự, lệnh hoặc cấu hình để câu \"thuần Việt\". Giải thích đầu vào, đầu ra, tác dụng và giới hạn bằng lời quanh chúng. Ví dụ cũ có thể sai; dẫn nguồn không thay thế kiểm tra kỹ thuật. [E02, E05, T05]\n\nNếu nhiệm vụ chỉ sửa văn phong, nhãn UI\u002Fthông báo được trích dẫn phải khớp sản phẩm. Nếu được giao sửa chính lời UI, nhãn đó là nội dung có thể sửa: cập nhật các chỗ tham chiếu tương ứng và vẫn giữ mã\u002Fđịnh danh không thuộc phạm vi sửa.\n\n### 11. Cho ví dụ đủ nhỏ và nói rõ nó chứng minh điều gì\n\nKhi cần, đưa đầu vào\u002Fthao tác, kết quả dự kiến và lời giải thích. Phân biệt kết quả quan sát ở một ví dụ với bảo đảm chung; tách lời quảng cáo được dẫn lại khỏi nhận xét hay kết quả của tác giả. Nếu đề bài không cung cấp hành vi sản phẩm, ghi giả định hoặc hỏi lại thay vì bịa ví dụ như một tính năng thật. [H02, E05, M02, N02]\n\nVí dụ lỗi có chủ đích trong bài dạy kiểm thử được phép nếu ghi rõ mục đích và kết quả mong đợi. Điều đó khác với cố tình thêm lỗi văn bản hoặc lỗi lệnh để giả phong cách con người.\n\n### 12. Giữ giọng bình tĩnh, giới hạn và cảnh báo\n\nKhông cần sao chép chuyện đùa, tục ngữ chế, giọng quảng cáo hay phán đoán tuyệt đối của blog. Nêu đánh đổi và điều chưa kiểm chứng. Đừng làm một câu cảnh báo \"nhẹ nhàng hơn\" bằng cách giảm mức nguy hiểm hoặc bỏ trách nhiệm. [C04, H01, H05, M01]\n\nTheo quy ước an toàn, đặt cảnh báo trước\u002Fsát thao tác có hậu quả; đây là lựa chọn biên tập, dù nhiều nguồn để hạn chế ở cuối bài. Mất kết nối không chứng minh yêu cầu chưa được lưu; chỉ hướng dẫn thử lại khi đã có căn cứ cho thấy làm vậy an toàn.\n\n## Áp dụng theo loại văn bản\n\nĐây là cách chuyển các nguyên tắc vào Coppice, không phải các thể loại đã được khảo sát đại diện:\n\n- **README:** cho biết mục đích, đối tượng, điều kiện chạy và các bước tối thiểu để dùng thử; dẫn tới giải thích dài hơn. Không thêm lời hứa hiệu năng.\n- **Hướng dẫn:** điều kiện → bước → kết quả kiểm tra; gọi rõ thành phần ở mỗi lần đổi tác nhân; cảnh báo trước bước gây tác động.\n- **Tra cứu:** dễ quét; tên chính xác, kiểu\u002Fgiá trị mặc định\u002Fphạm vi chỉ ghi khi có dữ kiện; không hy sinh điều kiện để ép mỗi mục thành một câu.\n- **Trang giới thiệu:** nói rõ ích lợi và giới hạn có căn cứ; không lấy lời khen chung thay cho hành vi cụ thể.\n- **UI\u002Flỗi:** ngắn nhưng giữ trạng thái biết\u002Fchưa biết, đối tượng và mức nghiêm trọng. Chỉ nêu hành động khôi phục đã được xác nhận an toàn.\n\n## Ví dụ biên tập tổng hợp\n\nĐây là các dữ kiện giả định dùng để thử cách biên tập, **không mô tả tính năng Coppice**.\n\n- Cho biết: ứng dụng sẽ chỉ lưu `config.json` khi người dùng bấm nhãn \"Lưu\". Viết: \"Ứng dụng sẽ chỉ lưu tệp `config.json` khi bạn bấm Lưu.\" Giữ sẽ, chỉ, điều kiện và nhãn.\n- Cho biết: trên Linux có thể khởi động nhanh hơn, phụ thuộc dữ liệu, không có bảo đảm cho mọi lần chạy. Viết: \"Trên Linux, tính năng này có thể giảm thời gian khởi động. Tuy nhiên, kết quả trên Linux còn phụ thuộc vào dữ liệu nên không có bảo đảm rằng lần chạy nào cũng nhanh hơn.\" **Không** đổi thành \"không phải lần chạy nào cũng nhanh hơn\": câu đó khẳng định đã có ngoại lệ.\n- Cho biết: kết nối thất bại; người nói không biết chắc yêu cầu đã được lưu. Viết: \"Không kết nối được. Chúng tôi không biết chắc yêu cầu đã được lưu hay chưa.\" Không đổi thành chưa lưu hoặc thêm lời mời thử lại.\n- Cho biết: tệp trong `out\u002F` sẽ bị ghi đè khi xuất; phải sao lưu tệp cần giữ trước đó. Viết: \"Các tệp hiện có trong `out\u002F` sẽ bị ghi đè khi xuất dữ liệu. Phải sao lưu các tệp cần giữ trước khi xuất.\" Câu bị động ở đây giữ đúng điều chưa xác định về tác nhân.\n\n## Rà soát trước khi giao\n\n- So từng ý trước\u002Fsau: cùng tác nhân, đối tượng, chuỗi kỹ thuật, số lượng, phạm vi và thứ tự?\n- Còn nguyên chỉ\u002Fmọi\u002Fít nhất, phủ định, trạng thái, phải\u002Fnên\u002Fcó thể và điều chưa biết?\n- Có chỗ lược chủ ngữ khiến không rõ ai làm? Có đổi thuật ngữ khiến tưởng là khái niệm khác?\n- Có thêm tính năng, quan hệ nhân quả, hiệu năng, bảo đảm an toàn hoặc bước khôi phục không có căn cứ?\n- Đọc thành lời: nhịp có tự nhiên, câu dài có cần thiết, câu ngắn có làm đứt điều kiện không?\n- Nếu mâu thuẫn kỹ thuật chưa giải quyết được, ghi rõ để người phụ trách kiểm tra. Không che nó bằng câu văn trôi chảy.\n",{"name":5,"description":7},"main","496bdbe6848c44791830e934a30ddfc75ff97670",".agents\u002Fskills\u002Fvietnamese-technical-writing",2,"https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice","https:\u002F\u002Fgetcoppice.app","https:\u002F\u002Fgithub.com\u002Ffertile-org","2026-11-15 02:44:23",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add fertile-org\u002Fcoppice --skill vietnamese-technical-writing",{"tool":37,"command":38},"bunx","bunx skills add fertile-org\u002Fcoppice --skill vietnamese-technical-writing",{"tool":40,"command":41},"pnpm","pnpm dlx skills add fertile-org\u002Fcoppice --skill vietnamese-technical-writing","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fvietnamese-technical-writing\u002FSKILL.md",true,[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"repo-reference-manifest.json","REFERENCE","参考文档",35605,"https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fvietnamese-technical-writing\u002Frepo-reference-manifest.json",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"repo-references.md",11547,"https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fvietnamese-technical-writing\u002Frepo-references.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"review-evidence.md",10011,"https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fvietnamese-technical-writing\u002Freview-evidence.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M75BVA54WAZ0PB33B2E91VTD","github-pull-requests","Open, inspect and update GitHub pull requests through the github__* tools. Load when a task asks to create a PR, read its diff or status, or update its title or body.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fmarketplace\u002Fcoppice\u002Fplugins\u002Fgithub\u002Fskills\u002Fgithub-pull-requests\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M75BV88K8DSPHNDJBD29Y5BK","github-issues","Read and update GitHub issues through the github__* tools. Load when a task names an issue, a bug report on GitHub, or asks to open, comment on, label or close one.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fmarketplace\u002Fcoppice\u002Fplugins\u002Fgithub\u002Fskills\u002Fgithub-issues\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M75BV3ZG33J7N858FNF1B1WP","github-code-review","Read a GitHub pull request review thread and leave review comments through the github__* tools. Load when a task asks to review a PR, answer review comments, or resolve feedback.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fmarketplace\u002Fcoppice\u002Fplugins\u002Fgithub\u002Fskills\u002Fgithub-code-review\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M75BV1AXRQQ7M6EF339ZZCZP","github-ci","Check GitHub Actions workflow runs and their logs through the github__* tools. Load when a task asks why CI failed, whether a branch is green, or to read a job's logs.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fmarketplace\u002Fcoppice\u002Fplugins\u002Fgithub\u002Fskills\u002Fgithub-ci\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M75BTZ7824GRE57036H3TR0A","design-ui-options","Use when a ticket changes what people see. Publish 2–3 clickable HTML options for the human to choose before you plan or build.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fbuiltin-plugins\u002Fdesign\u002Fskills\u002Fdesign-ui-options\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M75BTWRJ60EMTQ8WARHW3BPA","coppice-tech-lead-review","Tech Lead rules for Ready technical refinement (read-only) and for code review of in_review tickets.","https:\u002F\u002Fgithub.com\u002Ffertile-org\u002Fcoppice\u002Fblob\u002Fmain\u002Fserver\u002Fbuiltin-plugins\u002Fcoppice\u002Fskills\u002Fcoppice-tech-lead-review\u002FSKILL.md",[],[]]