OpenAI Plugins: Bộ sưu tập plugin Codex mẫu

Vấn đề nó giải quyết

OpenAI Plugins tồn tại vì một plugin Codex có một hình dạng cụ thể - một manifest `.codex-plugin/plugin.json`, cộng với các thư mục tùy chọn cho skills, cấu hình MCP, agents, commands và hooks - và đọc một bản đặc tả không cho bạn biết các phần đó kết hợp trong thực tế ra sao. Người xây plugin đầu tiên cần các ví dụ cụ thể, chạy được để sao chép, cùng một file marketplace chỉ cho Codex biết tìm chúng ở đâu. Repo này cung cấp cả hai.

Đây là gì?

OpenAI Plugins là bộ sưu tập chính thức của OpenAI chứa các plugin mẫu cho Codex. Theo README, mỗi plugin nằm dưới `plugins/<name>/` với một manifest bắt buộc `.codex-plugin/plugin.json` và các phần đi kèm tùy chọn: một thư mục `skills/`, `.app.json`, `.mcp.json`, `agents/` và `commands/` cấp plugin, một `hooks.json`, và `assets/`. Một marketplace mặc định tại `.agents/plugins/marketplace.json` trỏ tới thư mục `plugins/`, và người đăng nhập bằng API key có một marketplace riêng tại `.agents/plugins/api_marketplace.json`.

Vì sao đang được chú ý

Đây là một repository chính thức của OpenAI - khoảng 4.300 sao và 640 fork tại thời điểm viết - điều này quan trọng vì nó định nghĩa, bằng ví dụ, một plugin Codex hợp lệ trông ra sao. Khi mô hình plugin và marketplace của Codex dần định hình, repo còn đóng vai trò tài liệu bằng ví dụ: README nêu bật các bundle đầy đủ hơn cho Figma, Notion, xây app iOS và macOS, web app, và Expo, nên lập trình viên xem được plugin hoàn chỉnh thay vì chỉ một manifest trơ trọi.

Tính năng chính

• ✓Mỗi plugin nằm dưới `plugins/<name>/` với một manifest bắt buộc `.codex-plugin/plugin.json`
• ✓Các phần đi kèm tùy chọn cho mỗi plugin: `skills/`, `.app.json`, `.mcp.json`, `agents/`, `commands/`, `hooks.json`, và `assets/`
• ✓Một marketplace mặc định tại `.agents/plugins/marketplace.json` trỏ Codex tới thư mục `plugins/`
• ✓Một `api_marketplace.json` riêng cho người đăng nhập bằng API key
• ✓Các ví dụ đầy đủ hơn mà README nêu bật: figma, notion, build-ios-apps, build-macos-apps, build-web-apps, và expo
• ✓Các bundle bổ sung dựa trên skill và MCP cho netlify, remotion, và google-slides

Trường hợp dùng tốt nhất

• •Học cách bố trí manifest `plugin.json` bắt buộc trước khi tự viết một plugin Codex
• •Sao chép một ví dụ chạy được - figma, notion, hoặc expo - làm khung khởi đầu
• •Xem cách skills, MCP server, agents, commands và hooks kết hợp bên trong một plugin
• •Thiết lập một file marketplace plugin để Codex có thể tìm thấy các plugin của một đội

Cách cài đặt / dùng thử

README không nêu rõ các lệnh cài đặt. Trong thực tế bạn duyệt hoặc clone repo, và file marketplace tại `.agents/plugins/marketplace.json` mới là thứ trỏ Codex tới thư mục `plugins/`. Một `api_marketplace.json` riêng dành cho người đăng nhập bằng API key. Cách thiết lập từng bước cụ thể - làm sao đăng ký marketplace với Codex - không được ghi rõ trong README, nên hãy xem tài liệu của Codex để biết quy trình hiện tại.

Cách sử dụng

Bạn mở `plugins/<name>/`, đọc manifest `.codex-plugin/plugin.json` của nó, và chỉnh ví dụ theo plugin của riêng bạn - tái sử dụng cùng cấu trúc thư mục cho skills, cấu hình MCP, agents, commands và hooks. README trỏ tới các plugin Figma, Notion và Expo như những ví dụ đầy đủ hơn để nghiên cứu trước. Ngoài cách bố trí thư mục và các file marketplace, README không ghi chi tiết quy trình chạy, nên hãy coi repo như một tham chiếu để sao chép.

Lựa chọn thay thế

Ai nên thử — và ai nên bỏ qua

Lập trình viên đang xây hoặc đánh giá một plugin Codex, và các đội muốn một file marketplace chạy được để chuẩn hóa cách các plugin của họ được phát hiện. Nếu bạn không dùng OpenAI Codex, hoặc bạn muốn một công cụ cài được và được bảo trì thay vì một tập ví dụ để sao chép và chỉnh sửa, repo này không hợp.

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