Bộ Custom Skill toàn diện giúp AI Agent (Antigravity/Hermes) tương tác trực tiếp với các tài liệu văn phòng Word (.docx), Excel (.xlsx), và PowerPoint (.pptx) thông qua công cụ dòng lệnh OfficeCLI mà không cần cài đặt Microsoft Office.
GitHub chính thức của OfficeCLI: iOfficeAI/OfficeCLI
- Đường ray đôi (Dual-Track Layout):
- Track 1 (Chuẩn Hành chính Quốc gia NĐ 30): Đen trắng nghiêm ngặt, lề chuẩn xác đến từng twip, sử dụng bảng ẩn viền cho Header và Footer chữ ký.
- Track 2 (Chuẩn Doanh nghiệp / Thẩm mỹ): Kích hoạt Brand Kit, sử dụng theme colors, callout boxes, bảng zebra hiện đại.
- 10 Sub-skills Chuyên Biệt: Tự động định cấu hình cho từng loại tài liệu cụ thể: báo cáo, luận văn, pitch deck gọi vốn, mô hình tài chính, dashboard KPI, morph animation...
- QA Loop Tự Động: Tích hợp kiểm định lỗi định dạng (
view issues), validate cấu trúc XML (validate), và kết xuất HTML/Image (watch/screenshot) trước khi xuất bản. - Không Dependency: Chạy bằng 1 file binary duy nhất, cực kỳ nhẹ và nhanh trên môi trường Server/Cloud.
officecli-skill/
├── SKILL.md # Tệp định nghĩa skill chính cho AI Agent
├── README.md # Tài liệu hướng dẫn này
├── scripts/ # Kịch bản kiểm tra sức khỏe hệ thống
│ └── quick-test.ps1 # Script test nhanh kết nối và binary
├── resources/
│ └── bin/ # Thư mục chứa binary dự phòng (offline fallback)
│ └── officecli.exe # OfficeCLI binary cho Windows (v1.0.135)
├── examples/ # Các tài liệu mẫu và kịch bản mẫu
│ ├── README.md # Mục lục các ví dụ chi tiết
│ └── nd30-de-xuat.ps1 # Template kịch bản tạo Tờ trình/Đề xuất chuẩn NĐ 30
└── references/ # Tri thức nâng cao của Agent
├── officecli-commands.md # Cheat sheet các lệnh tiếng Việt
├── schemas/ # 119 Schema JSON chi tiết cho DOCX, XLSX, PPTX
└── skills/ # Mã nguồn và hướng dẫn của 10 sub-skills chuyên biệt
Sao chép thư mục skill này vào thư mục cấu hình Agent toàn cục hoặc cục bộ của bạn:
- Antigravity Global:
C:\Users\<Tên_User>\.gemini\config\skills\officecli - Project Local:
.agents/skills/officecli
Mở PowerShell và chạy lệnh cài đặt nhanh:
irm https://d.officecli.ai/install.ps1 | iex(Nếu cài đặt trực tuyến lỗi, Agent sẽ tự động fallback sang sử dụng file exe dự phòng sẵn có tại resources/bin/officecli.exe).
Kịch bản mẫu tại examples/nd30-de-xuat.ps1 trình bày phương án chuyển đổi số doanh nghiệp, đã vượt qua QA Loop đạt 0 lỗi định dạng.
Các tham số định dạng chuẩn twips được áp dụng:
marginLeft=1701 # Căn lề trái 3cm
marginRight=851 # Căn lề phải 1.5cm
marginTop=1134 # Căn lề trên 2cm
marginBottom=1134 # Căn lề dưới 2cm
font="Times New Roman"
fontSize=13pt
lineSpacing=1.3x # Giãn dòng 1.3
firstLineIndent=720 # Thụt đầu dòng 1.27cmWarning
Lỗi Giãn Dòng Trống trong Word (lineSpacing=312):
Trong Word OpenXML, nếu bạn chỉ định giá trị giãn dòng là số nguyên thuần (ví dụ lineSpacing=312) mà không có hậu tố đơn vị, OfficeCLI hoặc Word sẽ hiểu nhầm đó là giãn dòng gấp 312 lần hoặc 312pt (khoảng cách dòng cao bằng nửa trang giấy). Điều này khiến mỗi dòng chữ trong văn bản bị tự động đẩy sang một trang mới độc lập.
Giải pháp khắc phục: Luôn định nghĩa rõ ràng đơn vị multiplier (ví dụ: lineSpacing=1.3x, lineSpacing=1.5x) hoặc đơn vị điểm (ví dụ: lineSpacing=18pt).
Dự án được phân phối dưới giấy phép Apache License 2.0. Xem tệp LICENSE để biết thêm chi tiết.
Cơ sở công cụ được xây dựng dựa trên mã nguồn mở OfficeCLI.
Được đóng gói và tối ưu hóa bởi Minh Đỗ — Chuyên gia đào tạo AI Agent & EDT.