Tạo Văn Bản Hành Chính

Chương 1: Giới thiệu

Nghị định 30 là gì?

Nghị định 30/2020/NĐ-CP là văn bản quy phạm pháp luật quy định về công tác văn thư, bao gồm thể thức trình bày văn bản hành chính tại Việt Nam. Mọi cơ quan nhà nước, tổ chức chính trị, đơn vị sự nghiệp đều phải tuân thủ.

Skill này giải quyết vấn đề gì?

Hỗ trợ 2 loại văn bản

Chương 2: Cài đặt

Yêu cầu hệ thống

Cài đặt

# Vào thư mục skill
cd .agents/skill/Skill_The_Thuc_VB_ND30

# Cài thư viện
npm install

Cấu trúc thư mục

Skill_The_Thuc_VB_ND30/
├── SKILL.md                     ← Hướng dẫn cho AI Agent
├── README.md                    ← Giới thiệu cho người dùng
├── package.json                 ← Khai báo thư viện docx
├── scripts/
│   ├── generate_cong_van.js     ← Script sinh công văn
│   └── generate_quyet_dinh.js   ← Script sinh quyết định
└── references/
    ├── quy_tac_the_thuc.md      ← Thông số pixel-perfect
    └── phan_quyen_ky.md         ← Ma trận phân quyền ký

Cách sử dụng với AI Agent

Khi đã cài skill vào workspace, chỉ cần nói tự nhiên:

Agent sẽ tự động: thu thập thông tin → tra phân quyền ký → tạo JSON → chạy script → xuất file .docx.

Chương 3: Công văn

Công văn Văn bản không có tên loại - dùng để trao đổi, hướng dẫn, đề nghị.

Quy trình 5 bước

Cấu trúc JSON đầu vào

{
  "loai_van_ban": "cong_van",
  "co_quan_chu_quan": "BỘ TÀI CHÍNH",
  "co_quan_ban_hanh": "CỤC THUẾ TP. HÀ NỘI",
  "don_vi_soan_thao": "CT-HNi",
  "dia_danh": "Hà Nội",
  "trich_yeu": "V/v hướng dẫn kê khai thuế TNCN năm 2026",
  "kinh_gui": [
    "Các Chi cục Thuế quận, huyện",
    "Phòng Thuế thu nhập cá nhân"
  ],
  "noi_dung": "Nội dung công văn...",
  "cap_ky": "KT",
  "chuc_vu_cap_tren": "CỤC TRƯỞNG",
  "chuc_vu_ky": "PHÓ CỤC TRƯỞNG",
  "nguoi_ky": "Nguyễn Văn An",
  "noi_nhan": [
    "- Như trên;",
    "- Cục trưởng (để b/c);",
    "- Lưu: VT, TNCN (3b)."
  ]
}

Giải thích các trường

Lệnh chạy

node scripts/generate_cong_van.js --input data.json --output cong_van.docx

Chương 4: Quyết định

Quyết định Văn bản có tên loại - dùng khi ban hành quyết định hành chính.

Khác biệt so với Công văn

Cấu trúc JSON - Quyết định

{
  "loai_van_ban": "quyet_dinh",
  "co_quan_chu_quan": "BỘ TÀI CHÍNH",
  "co_quan_ban_hanh": "CỤC THUẾ TP. HÀ NỘI",
  "don_vi_soan_thao": "QĐ-CT",
  "trich_yeu": "Về việc thành lập Tổ công tác kiểm tra thuế",
  "can_cu": [
    "Luật Quản lý thuế số 38/2019/QH14",
    "Nghị định số 126/2020/NĐ-CP ngày 19/10/2020"
  ],
  "noi_dung": "Điều 1. Thành lập Tổ công tác...\nĐiều 2. Tổ công tác có nhiệm vụ...\nĐiều 3. Quyết định này có hiệu lực kể từ ngày ký.",
  "cap_ky": "TM",
  "chuc_vu_ky": "CỤC TRƯỞNG",
  "nguoi_ky": "Phạm Đình Hưng",
  "noi_nhan": [
    "- Như Điều 3;",
    "- Phòng KT1, KT2;",
    "- Lưu: VT, TCCB (5b)."
  ]
}

Trường riêng của Quyết định

Lệnh chạy

node scripts/generate_quyet_dinh.js --input data.json --output quyet_dinh.docx

Chương 5: Thông số thể thức

Tham chiếu Toàn bộ thông số pixel-perfect để sinh file .docx đúng chuẩn.

Khổ giấy và lề

Header - Table 2 cột x 2 dòng ẩn viền

Đây là phần quan trọng nhất và hay bị sai nhất. Header PHẢI dùng Table ẩn viền, KHÔNG dùng Tab hay Space.

Cấu trúc Header

+---------------------------+------------------------------------------+
| DÒNG 1 - CỘT TRÁI (3500) | DÒNG 1 - CỘT PHẢI (5571)                |
| - Tên cơ quan chủ quản    | - QUỐC HIỆU (in hoa, đậm, cỡ 13)       |
| - TÊN CƠ QUAN BAN HÀNH   | - Tiêu ngữ (đậm, thường, cỡ 14)         |
|   + Gạch ngang 1/3        |   + Gạch ngang = chiều dài tiêu ngữ      |
+---------------------------+------------------------------------------+
| DÒNG 2 - CỘT TRÁI (3500) | DÒNG 2 - CỘT PHẢI (5571)                |
| - Số, Ký hiệu            | - Địa danh, ngày tháng (nghiêng, cỡ 14) |
| - V/v (Trích yếu, cỡ 12) |                                          |
+---------------------------+------------------------------------------+

Thông số chi tiết Header

Body - Thông số khoảng cách

Kỹ thuật gạch ngang - Border Top

// Gạch dưới tên cơ quan (1/3 chiều rộng cột trái)
new Paragraph({
  spacing: { before: 20, after: 0 },
  border: {
    top: { style: BorderStyle.SINGLE, size: 2, color: "000000", space: 1 }
  },
  indent: { left: 1350, right: 1350 }
});

// Gạch dưới tiêu ngữ (bằng chiều dài chữ)
new Paragraph({
  spacing: { before: 20, after: 0 },
  border: {
    top: { style: BorderStyle.SINGLE, size: 2, color: "000000", space: 1 }
  },
  indent: { left: 1100, right: 1100 }
});

Chương 6: Phân quyền ký

Tham chiếu Quy định cách trình bày khối chữ ký theo cấp ký.

Các hình thức ký

Cách trình bày khối chữ ký

Bộ trưởng ký trực tiếp

                              BỘ TRƯỞNG
                          (Ký, ghi rõ họ tên)
                            Nguyễn Văn Thắng

Thứ trưởng ký thay (KT.)

                            KT. BỘ TRƯỞNG
                              THỨ TRƯỞNG
                          (Ký, ghi rõ họ tên)
                            Đỗ Thanh Trung

Vụ trưởng ký thừa lệnh (TL.)

                            TL. BỘ TRƯỞNG
                      VỤ TRƯỞNG VỤ TỔ CHỨC CÁN BỘ
                          (Ký, ghi rõ họ tên)
                            Nguyễn Văn A

Phó Vụ trưởng ký thừa ủy quyền (TUQ.)

                            TL. BỘ TRƯỞNG
                    KT. VỤ TRƯỞNG VỤ TỔ CHỨC CÁN BỘ
                           PHÓ VỤ TRƯỞNG
                          (Ký, ghi rõ họ tên)
                            Trần Văn B

Loại công việc tương ứng cấp ký

Thông số kỹ thuật khối chữ ký

Nơi nhận

Chương 7: Tham khảo nhanh

Lệnh tắt

Danh sách kiểm tra sau khi tạo file

Câu hỏi thường gặp

Tại sao dùng Border Top thay vì Underline?

UnderlineType gắn vào text, khi text thay đổi thì đường gạch cũng thay đổi. Border Top là đường viền của Paragraph, chiều dài cố định bằng indent, không phụ thuộc nội dung text.

Tỷ lệ 3500:5571 nghĩa là gì?

Đó là chiều rộng 2 cột header tính bằng đơn vị dxa (1 inch = 1440 dxa). Tỷ lệ này đảm bảo quốc hiệu "CỘNG HÒA XÃ HỘI CHỦ NGHĨA VIỆT NAM" không bị rớt chữ "NAM" xuống dòng mới.

Có thể thêm loại văn bản khác không?

Có. Tạo script mới (VD: generate_to_trinh.js) theo cùng cấu trúc. Header và chữ ký giống nhau, chỉ khác phần Body.

Tệp tham chiếu ở đâu?

Thông tin dự án