Dùng Gongwen Skill để tạo và kiểm tra DOCX công văn theo GB/T 9704-2012

Dự án giải quyết vấn đề gì

Gongwen GB/T 9704-2012 Skill là một công cụ mã nguồn mở dành cho các tài liệu chính thức bằng tiếng Trung. Công cụ không chỉ đặt tiêu đề bằng phông Heiti và nội dung chính bằng phông FangSong, mà còn xử lý các yếu tố định dạng như trang A4, vùng nội dung, tiêu đề, nội dung chính, cấp độ, trang đầu, tên cơ quan, số văn bản, người ký, ngày tháng và số trang theo các yêu cầu có thể thực thi của GB/T 9704-2012, đồng thời xuất tệp DOCX có thể tiếp tục chỉnh sửa.

Dự án phù hợp với báo cáo, phương án và tài liệu thuyết trình thông thường, đồng thời hỗ trợ công văn chính thức, bản in trên giấy tiêu đề đỏ có sẵn, công văn điện tử đầy đủ, thư, mệnh lệnh (lệnh) và biên bản. Sau khi tạo, tài liệu có thể tiếp tục được thêm bảng, phụ lục, ảnh con dấu trong Word hoặc WPS, hoặc được sắp xếp để đóng dấu thực tế.

GB/T 9704-2012 áp dụng cho việc ban hành công văn của các cơ quan đảng và chính quyền; các cơ quan, đơn vị khác có thể tham khảo để thực hiện. README cho biết tiêu chuẩn này tiếp tục có hiệu lực sau đợt rà soát ngày 30 tháng 5 năm 2025.

Chức năng chính và phạm vi sử dụng

• Tài liệu thông thường: mặc định sử dụng ordinary; ngay cả khi cung cấp tên cơ quan, công cụ cũng không tự động tạo tiêu đề đỏ.
• Ban hành công văn chính thức: phải chọn rõ formal. Chế độ giấy tiêu đề đỏ in sẵn chỉ dành chỗ cho tiêu đề đỏ và đường kẻ đỏ đã có trên giấy, không vẽ lại trong DOCX.
• Tiêu đề đỏ điện tử: chỉ khi thiết lập formal --letterhead digital, trình tạo mới vẽ đầy đủ các thành phần tiêu đề đỏ.
• Tên cơ quan và số văn bản: cung cấp qua --org và --doc-no. Định dạng chính thức sẽ từ chối các số văn bản rõ ràng không tuân thủ quy tắc về năm, dấu ngoặc lục giác, số thứ tự và chữ “号”.
• Tiêu đề và mục lục: tiêu đề bốn cấp được ghi vào các kiểu “Tiêu đề 1” đến “Tiêu đề 4” của Word/WPS cùng cấp độ dàn ý tương ứng, từ đó có thể chèn mục lục tự động.
• Số trang: hỗ trợ ba chế độ: căn giữa, trang chẵn lẻ và không hiển thị; tham số cụ thể phải căn cứ vào SKILL.md của dự án.
• Phụ lục và phần thông tin cuối văn bản: phụ lục có thể được tạo trên trang riêng và vẫn duy trì số trang liên tục của văn bản chính thức; thông tin nơi nhận hoặc phát hành có thể được neo ở cuối vùng nội dung của trang cuối.
• Xử lý thủ công: con dấu, dấu chữ ký, nội dung phụ lục và vị trí đóng dấu thực tế vẫn cần được bổ sung hoặc kiểm tra lại trong DOCX theo mục đích sử dụng.

Chuẩn bị dự án và môi trường chạy

Trước tiên, lấy kho lưu trữ từ địa chỉ dự án GitHub, sau đó vào thư mục gốc của dự án. Trình tạo và trình kiểm tra được thực thi bằng node, vì vậy máy cần có môi trường Node.js khả dụng; README không chỉ định phiên bản cụ thể, nên căn cứ vào các tập lệnh và kết quả kiểm thử hiện tại của kho lưu trữ.

Nếu chỉ muốn tạo DOCX trực tiếp, có thể chạy tập lệnh trong kho lưu trữ. Nếu muốn công cụ lập trình AI tự động đọc Skill này, có thể sử dụng trình cài đặt đa nền tảng.

macOS và Linux

scripts/install.sh --all

Windows

.\scripts\install.ps1 -All

Trình cài đặt liên kết cùng một thư mục nguồn với thư mục kỹ năng cấp người dùng trên từng nền tảng. Windows mặc định sử dụng phương thức sao chép để tránh vấn đề quyền đối với liên kết tượng trưng. Các nền tảng được hỗ trợ gồm Codex, Claude Code, OpenCode, Trae Code, Trae CLI, Kimi Code CLI, Kimi Code, WorkBuddy và ZCode. TraeWork sử dụng gói nhập dist/traework-gongwen-skill.zip trong kho lưu trữ.

Tạo tài liệu thông thường đầu tiên

Dự án cung cấp tệp đầu vào kiểm thử tests/fixture.md. Lệnh dưới đây chuyển đổi tệp này sang định dạng tài liệu thông thường và ghi vào thư mục tạm:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/gongwen.docx --format ordinary --title "公文格式回归测试"

Ý nghĩa các tham số chính như sau:

• --input: tệp nội dung đầu vào.
• --output: đường dẫn DOCX được tạo.
• --format ordinary: sử dụng định dạng báo cáo, phương án hoặc tài liệu thuyết trình thông thường.
• --title: đặt tiêu đề tài liệu.

Sau khi tạo xong, dùng trình kiểm tra để kiểm tra cấu trúc DOCX và các yếu tố định dạng mà công cụ có thể đảm bảo:

node scripts/verify_gongwen_docx.mjs --input /tmp/gongwen.docx --profile ordinary

Kiểm tra đạt không có nghĩa là có thể bỏ qua bước duyệt cuối cùng. Trước khi bàn giao chính thức, vẫn nên mở tệp trong Word hoặc WPS trên máy tính mục tiêu và kiểm tra ngắt dòng, ngắt trang, phông chữ, phụ lục và vị trí đóng dấu trong điều kiện in thực tế.

Tạo bản in trên giấy tiêu đề đỏ có sẵn

Nếu tài liệu cần được in lên loại giấy đã có biểu trưng cơ quan màu đỏ và đường kẻ đỏ, cần chọn rõ định dạng chính thức cùng chế độ giấy tiêu đề đỏ in sẵn:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

--letterhead-reserve-mm 72 nghĩa là dành chỗ 72 milimét ở trang đầu cho vùng tiêu đề đỏ đã có trên giấy. 72 milimét là giá trị mặc định; khi sử dụng thực tế, cần đo giấy tiêu đề đỏ của đơn vị và điều chỉnh trong phạm vi từ 37 đến 130 milimét được dự án hỗ trợ. Chế độ này không vẽ lại biểu trưng cơ quan màu đỏ và đường kẻ đỏ trong DOCX.

Sau đó sử dụng cấu hình định dạng chính thức tương ứng để kiểm tra:

node scripts/verify_gongwen_docx.mjs --input /tmp/formal.docx --profile formal --letterhead preprinted

Tạo tiêu đề đỏ điện tử đầy đủ

Chỉ sử dụng --letterhead digital khi thực sự cần vẽ đầy đủ các thành phần tiêu đề đỏ trong DOCX:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal-digital.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

Tiêu đề đỏ điện tử nhạy cảm hơn với môi trường phông chữ. Tiêu đề đỏ và tiêu đề tài liệu nên sử dụng phông Xiaobiaosong thực tế được cài đặt trên máy tính mục tiêu; nội dung chính và các phần khác cũng cần phông FangSong tiêu chuẩn. Khi trình tạo không tìm thấy các phông này, công cụ sẽ cảnh báo trong terminal và ghi lại phông thay thế được sử dụng.

Cấm thay thế phông chữ

Đối với các trường hợp bàn giao không chấp nhận việc thay thế phông chữ, hãy thêm --require-standard-fonts cho cả trình tạo và trình kiểm tra. Nếu máy tính hiện tại thiếu phông Xiaobiaosong hoặc FangSong tiêu chuẩn, lệnh sẽ dừng và liệt kê các phông bị thiếu thay vì tiếp tục xuất bản thay thế.

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/strict.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试" --require-standard-fonts
node scripts/verify_gongwen_docx.mjs --input /tmp/strict.docx --profile formal --letterhead digital --require-standard-fonts

Mục lục, phụ lục và các định dạng chuyên dụng

Tạo mục lục trong Word hoặc WPS

Trình tạo ghi tiêu đề bốn cấp vào các kiểu tiêu đề tiêu chuẩn và cấp độ dàn ý. Sau khi mở tài liệu, có thể chọn “Tham chiếu → Mục lục” trong Word/WPS để tạo hoặc cập nhật mục lục tự động. Việc có hiển thị tiêu đề cấp bốn hay không cần được lựa chọn trong phần cài đặt mục lục.

Thêm phụ lục

Bằng cách sử dụng lặp lại --attachment-file, có thể thêm nhiều phụ lục vào tài liệu trên các trang riêng. Trình tạo sẽ sắp xếp nhãn “Phụ lục”, tiêu đề dòng thứ ba và nội dung chính, đồng thời duy trì số trang liên tục của văn bản chính thức. Cấu trúc đầu vào cụ thể nên tham khảo SKILL.md trong kho lưu trữ.

Chọn nhánh tạo chuyên dụng

• Thư letter: tạo hai đường kẻ đỏ trên và dưới với kích thước chỉ định, đường dưới nằm ở chân trang và tắt số trang.
• Mệnh lệnh (lệnh) command: thực hiện các yêu cầu định dạng như chừa hai dòng trống bên dưới biểu trưng cơ quan và hai dòng trống bên dưới số lệnh.
• Biên bản minutes: đặt các nhãn “Tham dự”, “Xin phép” và “Tham dự với tư cách khách mời” bằng phông Heiti, danh sách nhân sự bằng phông FangSong.

Các loại này không chỉ là thay thế văn bản đơn giản trên định dạng thông thường, mà lần lượt đi vào các nhánh tạo tương ứng. Cần xác nhận loại văn bản trước khi lựa chọn.

Đề xuất sử dụng nâng cao

1. Không suy đoán loại tiêu đề đỏ dựa trên tên cơ quan. Tài liệu thông thường luôn phải chỉ rõ ordinary, còn công văn chính thức phải chỉ rõ formal.
2. Xác nhận giấy trước, rồi thiết lập khoảng trắng cho in lồng. Kích thước thực tế của giấy tiêu đề đỏ in sẵn có thể khác nhau theo mẫu của từng đơn vị, không nên máy móc sử dụng 72 milimét mặc định.
3. Cài đặt và xác minh phông chữ trong môi trường chỉnh sửa cuối cùng. Cùng một phông chữ có thể có tên khác nhau trên các hệ thống, Word và WPS; phông thay thế cũng có thể làm thay đổi cỡ chữ, giãn dòng và ngắt dòng.
4. Tận dụng kiểu tiêu đề để duy trì tài liệu dài. Không nên mô phỏng cấp mục lục thủ công, mà hãy sử dụng các kiểu Tiêu đề 1 đến Tiêu đề 4 do trình tạo ghi vào.
5. Kết hợp kiểm tra tự động với kiểm tra thủ công. Có thể tham khảo references/gbt9704-audit-matrix.md và references/formal-checklist.md trong kho lưu trữ để phân biệt các mục có thể kiểm tra tự động với các mục bắt buộc phải rà soát thủ công.
6. Chú ý logic dàn trang đặc biệt. Tiêu đề đỏ điện tử chính thức sử dụng các dòng trống 28 point rõ ràng để kiểm soát khoảng cách từ đường kẻ đỏ đến tiêu đề và từ biểu trưng cơ quan đến số văn bản; số văn bản và người phát hành của văn bản trình lên cấp trên sẽ được sắp xếp trên cùng một dòng.

Chạy kiểm thử dự án

Trong môi trường macOS hoặc Linux, có thể chạy bộ kiểm thử hồi quy do kho lưu trữ cung cấp:

tests/run_tests.sh

Bộ kiểm thử bao phủ việc tạo số trang căn giữa và trang chẵn lẻ, cấu trúc gói DOCX cũng như xác minh chuyển đổi PDF, nhằm chứng minh chuỗi tạo, kiểm tra và tạo tệp có thể in của trình tạo và trình kiểm tra có thể hoạt động. Việc cài đặt đa nền tảng cũng có thể được xác minh trong môi trường cô lập bằng tests/test-install.sh, bao gồm thư mục kỹ năng cục bộ và gói nhập TraeWork.

Lời kết

Gongwen Skill tập trung các quy tắc soạn thảo văn bản hành chính, vốn dễ bị phân tán trong lời nhắc, mẫu Word và các tập lệnh tạm thời, vào cùng một quy trình có thể bảo trì. Cách sử dụng ổn định nhất là: trước tiên chọn đúng bố cục thông thường hoặc chính thức, sau đó tạo DOCX, chạy trình kiểm tra, cuối cùng tiến hành rà soát thủ công trong Word/WPS mục tiêu, môi trường phông chữ và điều kiện in ấn thực tế. Dự án được cấp phép MIT, nhưng văn bản tiêu chuẩn và mẫu của cơ quan vẫn phải tuân thủ các quy định tương ứng về quyền và quản lý.