Skills và plugins: đóng gói quy trình lặp lại

English title: Skills and Plugins: Package Repeatable Workflows

Cập nhật: 29/06/2026. Đây là bài 6 trong chuỗi Codex Power 10 - 10 bài hướng dẫn dùng các năng lực mạnh của Codex theo cách có kiểm soát.

Bạn sẽ biết khi nào nên viết skill, khi nào cần plugin, và cách giữ bộ đóng gói này nhỏ nhưng đáng tin.

Bảng Nhớ Nhanh

Dùng bài này khi: một quy trình đã lặp lại vài lần và bạn muốn Codex làm ổn định hơn.

Không dùng bài này khi: bạn chưa hiểu quy trình hoặc mỗi lần làm vẫn khác nhau quá nhiều.

Xong bài khi: skill có trigger, đầu vào, bước làm, cổng kiểm tra và phạm vi không dùng.

Ghi nhớ: Bài thực hành này không cố làm bạn nhớ hết tính năng. Nó giúp bạn dựng một vòng làm việc có mục tiêu, có biên và có bằng chứng.

Trước Khi Bắt Đầu

• Chọn một quy trình đã chạy thật ít nhất hai lần.
• Viết rõ khi nào dùng và khi nào không dùng skill.
• Có cổng kiểm tra đầu ra, không chỉ danh sách bước.

Cẩn trọng: Nếu môi trường hoặc quyền đang mơ hồ, hãy dừng một nhịp để kiểm tra. Agent chạy nhanh trong bối cảnh sai sẽ tạo ra diff rất thuyết phục nhưng khó dùng.

Ý Tưởng Trong 3 Phút

Nếu một quy trình đã lặp lại ba lần, bạn không nên tiếp tục nhắc nó bằng tay. Ví dụ: viết bài, rà soát bảo mật, tạo changelog, kiểm tra release. Mỗi lần lặp là cơ hội đóng gói thành skill.

Skill là công thức. Plugin là hộp dụng cụ có nhiều công thức và công cụ đi kèm. Đừng viết plugin khi một skill đã đủ; đừng nhồi tất cả vào skill khi quy trình cần nhiều năng lực phối hợp.

• Skill nên có trigger rõ, mục tiêu, đầu vào, các bước, cổng kiểm tra và định dạng đầu ra.
• Plugin phù hợp khi bạn cần đóng gói nhiều skill, lệnh, cấu hình hoặc tool cho một miền công việc.
• Skill tốt không chỉ nói làm gì; nó nói khi nào dùng và khi nào không dùng.
• Đóng gói quá sớm dễ tạo nợ vận hành. Hãy bắt đầu từ quy trình đã chứng minh bằng vài lần chạy thật.

Công Thức 1: Chạy Quy Trình Chính

Khi dùng: một quy trình đã lặp lại vài lần và bạn muốn Codex làm ổn định hơn.

1. Chọn một quy trình lặp lại có giá trị cao và ít biến thiên.
2. Viết skill một trang: mục tiêu, đầu vào, các bước, cổng kiểm tra.
3. Chạy thử trên hai tình huống khác nhau, ghi lại điểm agent hay bỏ sót.
4. Chỉ nâng lên plugin khi cần phân phối nhiều skill hoặc công cụ cho cùng một miền.

Công Thức 2: Đóng Cổng Kiểm Chứng

Một phiên tốt không cần lúc nào cũng dài. Điều cần giữ là nhịp: giao việc rõ, để Codex đọc đúng, cho nó thực hiện trong phạm vi nhỏ, rồi bắt nó tự chứng minh kết quả.

Prompt Mẫu

Tên skill: article-visual-kit
 
Khi dùng: bài viết cần hero hoặc infographic.
Đầu vào: slug, audience, key message, visual type.
Các bước: chọn loại visual, viết đề bài, kết xuất ảnh, gắn vào MDX, kiểm tra build.
Cổng kiểm tra: ảnh có minh họa rõ, chữ không sai dấu, file tồn tại trong public/generated.

Ví Dụ Tối Thiểu: Skeleton của một skill

---
name: article-visual-kit
description: Use when a blog article needs a hero image, infographic, and publish checks.
---
 
Inputs: slug, audience, key message, visual type.
Steps: choose visual, draft brief, render asset, attach to MDX, run checks.
Done when: image exists, text is correct, build passes.

Khi Có Lỗi

Nếu gặp một trong các lỗi trên, cách sửa thường không phải là viết prompt dài hơn. Cách sửa là thêm đúng mảnh còn thiếu: một đường dẫn ngữ cảnh, một ràng buộc phạm vi, hoặc một tiêu chí nghiệm thu.

Quy Trình Trong Đội

Đội nên có thư viện skill theo việc thật: rà soát code, viết test, chuẩn bị release, viết tài liệu, tạo infographic. Mỗi skill có owner và ngày cập nhật.

Với đội mới bắt đầu, đừng đưa Codex vào khâu rủi ro nhất ngay. Hãy bắt đầu ở nơi có phản hồi nhanh: viết test, tạo bản nháp, rà link, chuẩn hóa tài liệu, tạo ảnh minh họa, hoặc chuẩn bị diff nhỏ để con người rà soát.

Bài Tập 30 Phút

1. Chọn một repo, bài viết hoặc màn hình thật để thực hành.
2. Viết một câu mục tiêu cho bài 6, tránh yêu cầu chung chung.
3. Liệt kê đúng ba nguồn context mà Codex nên đọc trước.
4. Ghi hai ràng buộc không được vượt.
5. Viết Done-when bằng bằng chứng có thể kiểm tra.
6. Chạy prompt trong Codex CLI hoặc Codex App.
7. Dừng sau plan đầu tiên và xem Codex có hiểu đúng không.
8. Cho Codex làm phần nhỏ nhất có thể.
9. Đóng gate: Trigger, Steps, Assets, Test.
10. Ghi lại một điều nên đưa vào prompt hoặc AGENTS.md cho lần sau.

10 Điều Cần Nhớ

1. Skill là công thức cho việc lặp.
2. Plugin là gói phân phối rộng hơn skill.
3. Description quyết định Codex có chọn đúng skill không.
4. Progressive disclosure giữ context nhẹ.
5. Skill phải nói khi nào không dùng.
6. Cổng kiểm tra biến checklist thành chất lượng.
7. Scripts phù hợp cho bước cần tính xác định.
8. References phù hợp cho hướng dẫn dài.
9. Đóng gói quá sớm tạo nợ vận hành.
10. Skill tốt bắt đầu từ một quy trình đã chạy thật.

Nguồn tham khảo chính: OpenAI Codex documentation. Bài tiếp: MCP và connectors: đưa dữ liệu đúng vào phiên làm việc.