Xây dựng skill

Sử dụng skill dành cho tác nhân để mở rộng ChatGPT và Codex với các khả năng dành riêng cho từng tác vụ. Một skill đóng gói hướng dẫn, tài nguyên và các tập lệnh tùy chọn để cả hai sản phẩm có thể thực hiện một quy trình một cách đáng tin cậy. Skill được xây dựng dựa trên tiêu chuẩn mở về skill dành cho tác nhân.

Skill là định dạng biên soạn cho các quy trình có thể tái sử dụng. Plugin phân phối các skill và trình kết nối có thể tái sử dụng thông qua thư mục plugin chung được ChatGPT và Codex chia sẻ. Plugin hoạt động trong Chat và Work trên ChatGPT phiên bản web, máy tính và thiết bị di động, trong Codex thuộc ứng dụng ChatGPT dành cho máy tính và thông qua Codex CLI. Hãy dùng skill để thiết kế chính quy trình, sau đó đóng gói quy trình đó dưới dạng plugin khi bạn muốn người khác cài đặt.

Các skill độc lập có sẵn trong ứng dụng ChatGPT dành cho máy tính, Codex CLI và tiện ích IDE. Các skill được đóng gói trong plugin cũng có sẵn trong Chat và Work trên ChatGPT phiên bản web, máy tính và thiết bị di động.

Trong ứng dụng ChatGPT dành cho máy tính, hãy mở Skills trên thanh bên để xem và khám phá các skill được tạo trong các dự án của bạn.

Trong Codex, danh sách ban đầu cũng bao gồm đường dẫn tệp của từng skill. Để tránh chiếm chỗ của phần còn lại trong lời nhắc, danh sách này sử dụng tối đa 2% cửa sổ ngữ cảnh của mô hình, hoặc 8.000 ký tự khi không xác định được cửa sổ ngữ cảnh. Nếu có nhiều skill được cài đặt, trước tiên Codex sẽ rút gọn phần mô tả skill. Với các tập hợp skill lớn, Codex có thể bỏ qua một số skill khỏi danh sách ban đầu và hiển thị cảnh báo.

Ngân sách này chỉ áp dụng cho danh sách skill ban đầu. Khi Codex chọn một skill, Codex vẫn đọc toàn bộ hướng dẫn SKILL.md của skill đó.

Một skill là một thư mục có tệp SKILL.md cùng các tập lệnh và tài liệu tham khảo tùy chọn. Tệp SKILL.md phải bao gồm name và description.

Cách ChatGPT và Codex sử dụng skill

ChatGPT và Codex có thể kích hoạt skill theo hai cách:

1. Gọi trực tiếp: Đưa skill trực tiếp vào prompt của bạn. Trong ChatGPT, nhập @ để chọn một skill. Trong Codex CLI hoặc tiện ích mở rộng IDE, chạy /skills hoặc nhập $ để đề cập đến một skill.
2. Gọi ngầm định: ChatGPT hoặc Codex có thể chọn một skill khi tác vụ của bạn khớp với description của skill đó.

Vì việc so khớp ngầm định phụ thuộc vào description, hãy viết phần mô tả ngắn gọn với phạm vi và ranh giới rõ ràng. Đặt trường hợp sử dụng chính và các từ khóa kích hoạt ở đầu để ứng dụng chủ vẫn có thể so khớp skill nếu phần mô tả bị rút gọn.

Tạo một skill

Nếu bạn đã nắm rõ quy trình và việc minh họa dễ hơn mô tả, hãy dùng Record & Replay. Trình ghi sẽ ghi lại quy trình, kiểm tra các bước và soạn một skill có thể tái sử dụng từ phần minh họa đó.

Nếu bạn muốn mô tả skill, hãy dùng công cụ tạo tích hợp sẵn. Trong ChatGPT Work, gọi công cụ này bằng @skill-creator. Trong Codex, gọi công cụ như sau:

$skill-creator

Trình tạo hỏi skill làm gì, khi nào nên kích hoạt và skill chỉ nên gồm hướng dẫn hay bao gồm cả tập lệnh. Mặc định là chỉ gồm hướng dẫn.

Bạn cũng có thể tạo skill theo cách thủ công bằng cách tạo một thư mục có tệp SKILL.md:

---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---

Skill instructions for ChatGPT or Codex to follow.

Codex tự động phát hiện thay đổi của skill. Nếu bản cập nhật không xuất hiện, hãy khởi động lại Codex.

Nơi Codex tải các skill cục bộ

Codex đọc skill từ các vị trí kho lưu trữ, người dùng, quản trị viên và hệ thống. Đối với kho lưu trữ, Codex quét .agents/skills trong mọi thư mục từ thư mục làm việc hiện tại đến thư mục gốc của kho lưu trữ. Nếu hai skill có cùng name, Codex không hợp nhất chúng; cả hai đều có thể xuất hiện trong bộ chọn skill.

Codex hỗ trợ thư mục skill được liên kết tượng trưng và đi theo đích của liên kết tượng trưng khi quét các vị trí này.

Các vị trí này dùng để biên soạn và khám phá cục bộ. Khi muốn phân phối các skill có thể tái sử dụng bên ngoài một repo duy nhất, hoặc tùy chọn đóng gói chúng cùng các trình kết nối, hãy dùng plugin.

Phân phối skill bằng plugin

Các thư mục skill trực tiếp phù hợp nhất cho việc biên soạn cục bộ và các quy trình có phạm vi trong repo. Nếu muốn phân phối một skill có thể tái sử dụng, đóng gói từ hai skill trở lên cùng nhau hoặc phát hành một skill kèm theo trình kết nối, hãy đóng gói chúng dưới dạng plugin.

Plugin có thể chứa một hoặc nhiều skill. Plugin cũng có thể tùy chọn đóng gói các kết nối MCP server đã đăng ký, cấu hình MCP server đi kèm và tài nguyên trình bày trong một gói duy nhất.

Cài đặt các skill được tuyển chọn để sử dụng cục bộ

Để thêm các skill được tuyển chọn ngoài những skill tích hợp cho thiết lập Codex cục bộ của riêng bạn, hãy dùng $skill-installer. Ví dụ: để cài đặt skill $linear:

$skill-installer linear

Bạn cũng có thể yêu cầu trình cài đặt tải skill xuống từ các kho lưu trữ khác. Codex tự động phát hiện skill mới được cài đặt; nếu một skill không xuất hiện, hãy khởi động lại Codex.

Hãy dùng cách này cho thiết lập và thử nghiệm cục bộ. Để phân phối có thể tái sử dụng các skill của riêng bạn, nên ưu tiên plugin.

Bật hoặc tắt các skill Codex cục bộ

Dùng các mục [[skills.config]] trong ~/.codex/config.toml để tắt một skill mà không xóa nó:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Khởi động lại Codex sau khi thay đổi ~/.codex/config.toml.

Siêu dữ liệu tùy chọn

Thêm agents/openai.yaml để cấu hình siêu dữ liệu giao diện trong ứng dụng ChatGPT dành cho máy tính, đặt chính sách gọi và khai báo các phần phụ thuộc công cụ để có trải nghiệm sử dụng skill liền mạch hơn.

interface:
  display_name: "Optional user-facing name"
  short_description: "Optional user-facing description"
  icon_small: "./assets/small-logo.svg"
  icon_large: "./assets/large-logo.png"
  brand_color: "#3B82F6"
  default_prompt: "Optional surrounding prompt to use the skill with"

policy:
  allow_implicit_invocation: false

dependencies:
  tools:
    - type: "mcp"
      value: "openaiDeveloperDocs"
      description: "OpenAI Docs MCP server"
      transport: "streamable_http"
      url: "https://developers.openai.com/mcp"

allow_implicit_invocation (mặc định: true): Khi false, Codex sẽ không gọi ngầm skill dựa trên lời nhắc của người dùng; việc gọi $skill rõ ràng vẫn hoạt động.

Các phương pháp hay nhất

• Giữ mỗi skill tập trung vào một công việc.
• Ưu tiên hướng dẫn hơn tập lệnh, trừ khi bạn cần hành vi mang tính xác định hoặc công cụ bên ngoài.
• Viết các bước ở thể mệnh lệnh với đầu vào và đầu ra rõ ràng.
• Kiểm thử lời nhắc dựa trên mô tả skill để xác nhận hành vi kích hoạt chính xác.

Để xem thêm ví dụ, hãy tham khảo Sửa lỗi GitHub CI, PDF, Linear, openai/skills và đặc tả skill dành cho tác nhân. Để phân phối dưới dạng có thể cài đặt, nên dùng plugin.