Gói kỹ năng chuyên biệt dành cho tác vụ tạo và chỉnh sửa tệp trình chiếu (.pptx) trên nền tảng Claude Code được thiết kế để chuyển đổi yêu cầu ngôn ngữ tự nhiên thành tài liệu slide hoàn chỉnh. Giải pháp này tận dụng các thư viện lập trình mạnh mẽ để đảm bảo hiệu suất cao và tính ổn định trong môi trường tự động hóa.

1. Lớp Tiền Xử Lý và Thực Thi Script

Kho lưu trữ chứa các hàm xử lý cốt lõi có nhiệm vụ chuyển hóa thông tin đầu vào thành kết quả cuối cùng. Nhóm công cụ này không chạy trực tiếp mà được kích hoạt bởi hệ thống điều khiển dựa trên dữ liệu JSON nhận được.

• Công nghệ nền tảng: Sử dụng JavaScript Runtime (Node.js) kết hợp với thư viện pptxgenjs.
• Mục đích: Giảm thiểu lỗi cú pháp khi sinh ra mã nguồn phức tạp bằng cách gọi các hàm đã được tối ưu hóa sẵn.
• Danh sách các module chức năng:
  • create_slide_bundle.js: Chức năng tạo khung sườn mới từ định dạng dữ liệu JSON.
  • modify_structure.js: Công cụ cập nhật nội dung slide hiện hữu hoặc thay thế hình ảnh.
  • parse_existing.pptx: Trích xuất dữ liệu thô từ các tập tin bên ngoài.
  • inject_design_style.js: Áp dụng giao diện mẫu tùy chỉnh lên sản phẩm cuối.

2. Tài Liệu Định Nghĩa và Hướng Dẫn API

Để AI có thể hiểu đúng phạm vi hoạt động và giới hạn, một số tài liệu hướng dẫn bắt buộc phải được nạp vào ngữ cảnh xử lý.

a. File mô tả kỹ năng (SkillManifest.md)

Đây là tài liệu khai báo quyền năng chính. Nó cung cấp các thông tin cần thiết như tên gói, danh sách các phép toán hỗ trợ (tạo, sửa, xuất), và các ràng buộc về mặt kỹ thuật (không hỗ trợ animation phức tạp). Đây cũng là nơi chứa ví dụ về chuỗi lệnh tự nhiên mà người dùng có thể nhập.

b. Reference Documentation (library_doc.md)

Đóng vai trò như sổ tay tra cứu đối với thư viện pptxgenjs. Khi cần viết logic bổ sung, hệ thống sẽ tham chiếu file Markdown này để đảm bảo cú pháp hàm gọi đúng chuẩn API mà không gặp lỗi biên dịch.

c. Quy tắc xử lý nâng cao (best_practices.md)

Hướng dẫn cách thao tác an toàn với tệp tin gốc để tránh làm hỏng định dạng. Bao gồm các chiến lược chỉnh sửa hàng loạt như đồng bộ font chữ, màu sắc nền across all slides.

3. Bộ Quản Trị Cấu Hình

Các tham số cài đặt quyết định vẻ ngoài và hành vi mặc định của dự án.

Một. Cấu hình mặc định toàn cục (config_base.json)

Tập tin này quy định tiêu chuẩn chung cho mọi lần thực thi:

{
  "presentation_aspect": "16:9",
  "theme_mode": "corporate_clean",
  "primary_font_family": "Segoe UI",
  "slide_count_threshold": 30,
  "allow_data_visualization": true,
  "media_support_level": "embedded",
  "destination_folder": "./generated_slides"
}

Nhai. Cấu hình riêng biệt cho dự án (env_override.json)

Tập tin nằm trong vùng trắng `.gitignore` nhằm phủ lấp các giá trị mặc định ở trên. Dùng để lưu trữ lộ trình làm việc cá nhân hoặc quy chuẩn nội bộ của tổ chức.

{
  "font_preference": "Roboto Condensed",
  "template_source": "./brand_assets/master_template.pptx",
  "save_location": "/local/presentations_final"
}

4. Quy Trình Vận Hành Tiêu Chuẩn

Khi nhận được mệnh lệnh tạo nội dung, luồng xử lý diễn ra tuần tự như sau:

1. AI quét lại hồ sơ năng lực (SkillManifest.md) để xác nhận khả năng thực hiện.
2. Tương tác với người dùng để thu thập thông tin chi tiết về kịch bản.
3. Tham khảo tài liệu API (library_doc.md) để xác định phương thức triển khai kỹ thuật.
4. Ghép nối các tham số từ tập tin cấu hình.
5. Kích hoạt module tạo tập hợp slide (create_slide_bundle.js) với dữ liệu đầu vào đã được chuẩn hóa.
6. Hoàn tất vòng lặp và thông báo vị trí lưu trữ kết quả.

5. Tối Ưu Hóa Và Mở Rộng

Người dùng có thể tùy chỉnh sâu hơn thông qua các bước sau:

• Liên kết Template: Chỉnh sửa đường dẫn tới tập tin .pptx định mức của doanh nghiệp trong phần cấu hình môi trường.
• Điều chỉnh giao diện: Thay đổi từ khóa chỉ định style trong cấu hình hệ thống.
• Mở rộng kho chức năng: Bổ sung thêm mô tả trong file manifest và phát triển script tương ứng để xử lý các yêu cầu đặc thù mới.
• Quy tắc xuất file: Chỉ định thư mục đích đến cụ thể để quản lý dữ liệu dễ dàng hơn.