Xây dựng skill

Sử dụng skill dành cho tác nhân để mở rộng 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à tập lệnh tùy chọn để Codex có thể tuân theo quy trình làm việc một cách đáng tin cậy. Skill được xây dựng dựa trên tiêu chuẩn skill tác nhân mở.

Skill là định dạng biên soạn cho quy trình làm việc có thể tái sử dụng. Plugin phân phối các skill và connector có thể tái sử dụng đến ChatGPT Work trên web cũng như ChatGPT Work và Codex trong ứng dụng dành cho máy tính. Codex CLI cũng có thể cài đặt plugin. Hãy dùng skill để thiết kế chính quy trình làm việc, sau đó đóng gói thành plugin khi bạn muốn những người khác trong không gian làm việc cài đặt quy trình đó.

Skill khả dụng trong ứng dụng ChatGPT dành cho máy tính, Codex CLI và tiện ích IDE.

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

Skill sử dụng tiết lộ tăng dần để quản lý ngữ cảnh hiệu quả: Codex bắt đầu với tên, mô tả và đường dẫn tệp của từng skill. Codex chỉ tải toàn bộ hướng dẫn SKILL.md khi quyết định sử dụng một skill.

Codex đưa danh sách skill khả dụng ban đầu vào ngữ cảnh để có thể chọn đúng skill cho tác vụ. Để tránh lấn át phần còn lại của lời nhắc, danh sách này chỉ 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 mô tả skill. Với 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.

my-skill/
├── SKILL.md          # Required: instructions and metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates and resources
└── agents/
    └── openai.yaml   # Optional: appearance and dependency declarations

Cách Codex sử dụng skill

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

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

Vì việc khớp ngầm phụ thuộc vào description, hãy viết 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à từ khóa kích hoạt ở đầu để Codex vẫn có thể khớp skill nếu mô tả bị rút gọn.

Tạo một skill

Nếu bạn đã biết quy trình làm việc và việc trình diễn dễ hơn mô tả, hãy dùng Ghi & Phát lại. Codex ghi lại quy trình làm việc, kiểm tra các bước và tạo bản nháp skill có thể tái sử dụng từ phần trình diễn.

Nếu muốn mô tả skill, hãy dùng trình tạo tích hợp:

$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 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 lưu skill

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ành cho việc biên soạn và khám phá cục bộ. Khi bạn muốn phân phối skill có thể tái sử dụng ra ngoài một kho lưu trữ hoặc tùy chọn đóng gói chúng cùng connector, hãy dùng plugin.

Phân phối skill bằng plugin

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

Plugin có thể bao gồm một hoặc nhiều skill. Plugin cũng có thể tùy chọn đóng gói ánh xạ ứng dụng, cấu hình máy chủ MCP 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 skill

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 xem Sửa lỗi GitHub CI, PDF, Linear, openai/skills và đặc tả skill tác nhân. Đối với phân phối có thể cài đặt, hãy ưu tiên plugin.