Bạn đã nghe về Codex subagents – những trợ lý AI chuyên biệt giúp OpenAI Codex CLI xử lý tác vụ phức tạp mà không làm loãng ngữ cảnh chính – nhưng giữa hàng trăm ý tưởng, đâu mới là bộ sưu tập đáng tin cậy? Repository awesome-codex-subagents chính là câu trả lời, với hơn 171 subagent được phân loại rõ ràng, sẵn sàng copy vào dự án Codex của bạn trong vài phút.
Thank you for reading this post, don't forget to subscribe!Những điểm chính
- Bộ sưu tập 171+ subagent viết bằng TOML, thiết kế riêng cho Codex CLI, phủ 13 danh mục từ phát triển cốt lõi, ngôn ngữ, hạ tầng đến AI Governance.
- Mỗi subagent có mô tả rõ khi nào nên gọi, model được chọn lọc thông minh và chế độ sandbox đọc/ghi minh bạch, giúp bạn kiểm soát rủi ro.
- Cài đặt đơn giản: copy file .toml vào thư mục agent toàn cục hoặc của dự án, Codex sẽ nhận diện và bạn chỉ cần uỷ thác rõ ràng trong prompt.
- Phù hợp nhất với team đang dùng Codex CLI muốn chuẩn hoá quy trình và mở rộng năng lực chuyên môn, nhưng không phải phép màu cho script đơn giản.
Awesome Codex Subagents là gì và giải quyết vấn đề gì?
Đây là một kho lưu trữ cộng đồng tập hợp các định nghĩa subagent dành riêng cho Codex CLI của OpenAI. Thay vì tự mày mò viết chỉ dẫn cho từng vai trò như backend developer, security auditor hay data engineer, bạn có ngay một catalogue 171+ file TOML đã được tinh chỉnh, bám sát tài liệu chính thức của Codex. Vấn đề cốt lõi mà repo này giải quyết là sự phân mảnh ngữ cảnh và thiếu nhất quán khi dùng nhiều agent.
Khi bạn giao việc trực tiếp trong cửa sổ chat, các tác vụ chuyên sâu dễ làm đầy bộ nhớ và giảm chất lượng phản hồi. Subagents cô lập từng nhiệm vụ trong không gian ngữ cảnh riêng, giúp Codex tập trung và cho ra kết quả chính xác hơn hẳn. Bạn chỉ cần uỷ thác rõ ràng, không lo agent tự động spawn lung tung, đúng như triết lý của nhà phát triển Codex.
Repo phân nhóm subagent thành 13 danh mục lớn: Core Development với những con bài như api-designer, frontend-developer; Language Specialists từ python-pro đến rust-engineer; Infrastructure với terraform-engineer, sre-engineer; Quality & Security có code-reviewer, penetration-tester; Data & AI với mlops-engineer, nlp-engineer; Developer Experience như git-workflow-manager, mcp-developer; và nhiều nhóm đặc thù khác như AI Governance, Platform Engineering, hay LLMOps. Tất cả đều dùng cấu trúc TOML quen thuộc, khai báo model, sandbox_mode và chỉ dẫn chi tiết bên trong.
Những tính năng nổi bật của bộ sưu tập subagents
Điểm mạnh đầu tiên là Smart Model Routing. Mỗi subagent gắn sẵn một model phù hợp, ví dụ gpt-5.4 cho các tác vụ suy luận sâu như kiểm toán bảo mật, còn gpt-5.3-codex-spark cho tra cứu nhanh và tổng hợp. Bạn không phải nhớ model nào tốt cho việc gì, cứ copy file về là agent tự chọn đúng ‘động cơ’. Tiếp theo là Sandbox Mode rõ ràng: các agent reviewer, auditor mặc định ở chế độ read-only, không thể sửa file; trong khi developer, engineer được phép ghi workspace. Điều này giảm thiểu rủi ro chỉnh sửa ngoài ý muốn, đặc biệt quan trọng khi chạy audit tự động.
Một ưu điểm lớn nữa là tính chia sẻ được. Bạn có thể đặt subagent trong thư mục toàn cục ~/.codex/agents/ để dùng chung cho mọi dự án, hoặc trong .codex/agents/ của repo cụ thể. Khi có xung đột tên, bản ở dự án sẽ được ưu tiên. Nhờ đó, team bạn duy trì được quy chuẩn chung mà vẫn linh hoạt điều chỉnh cho từng repo. Repository còn kèm theo những workflow mẫu ấn tượng: PR review song song với reviewer và docs-researcher, điều tra bug phối hợp code-mapper, browser-debugger và frontend-developer. Đây chính là kịch bản thực chiến mà dân DevOps hay team lead sẽ mê ngay.
Hướng dẫn cài đặt và sử dụng Codex Subagents
Cách đưa subagent vào Codex không thể đơn giản hơn. Bạn chỉ cần clone repo này về, sau đó copy file .toml mong muốn vào đúng thư mục agent mà Codex đọc. Dưới đây là các bước cụ thể:
- Clone repository:
git clone https://github.com/VoltAgent/awesome-codex-subagents.git - Tạo thư mục agent toàn cục nếu chưa có:
mkdir -p ~/.codex/agents - Copy subagent mong muốn, ví dụ backend-developer:
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/ - Đối với agent chỉ dùng trong dự án hiện tại, tạo thư mục
.codex/agentstrong repo và copy file vào đó. - Khởi động lại hoặc làm mới phiên Codex nếu cần.
- Khi chat với Codex, bạn phải uỷ thác tường minh – Codex không tự động spawn subagent. Ví dụ: “Use backend-developer to review the API structure and suggest improvements.”
Một lưu ý quan trọng: nếu bạn đã có file cấu hình .codex/config.toml, phần khai báo agent nên đặt dưới mục [agents] theo đúng tài liệu chính thức. Các file subagent trong repo này là các định nghĩa độc lập, không xung đột. Sau khi copy, bạn có thể kiểm tra nhanh bằng cách yêu cầu Codex liệt kê agent khả dụng hoặc gọi thử một tác vụ nhẹ. Kinh nghiệm của tôi là nên bắt đầu với reviewer hoặc frontend-developer để làm quen nghen, vì output của chúng rất dễ đánh giá và giúp bạn hiểu cách Codex vận hành subagent.
Ai nên dùng — ai không nên?
Bộ sưu tập này sinh ra cho lập trình viên đang dùng Codex CLI hàng ngày, đặc biệt là những ai thường xuyên làm việc đa vai trò: viết code, review, audit bảo mật, thiết kế hệ thống. Nếu team bạn đã có quy trình CI/CD và muốn tự động hoá phần kiểm tra chất lượng bằng AI, thì các subagent như reviewer, security-auditor, hay performance-engineer là trợ thủ đắc lực. Các bạn làm sản phẩm, AI engineer hay DevOps cũng sẽ thấy hữu ích vì có hẳn nhóm LLMOps, Evals và Platform Engineering.
Ngược lại, nếu bạn chỉ thỉnh thoảng dùng Codex để hỏi những câu đơn giản, generate một hàm nhỏ hoặc chưa quen với kiến trúc agent, thì kho subagents này có thể gây rối hơn là giúp ích. Codex không tự động gọi subagent, nên nếu bạn không biết cách uỷ thác, bạn sẽ không thấy khác biệt. Ngoài ra, các file subagent chỉ là điểm khởi đầu – bạn vẫn cần đọc và điều chỉnh cho khớp với stack riêng. Đừng kỳ vọng copy nguyên xi là chạy ngon mọi tình huống nha. Tóm gọn: đây là vũ khí cho người dùng Codex có tổ chức, không phải cho người mới tò mò cầm thử.
Câu hỏi thường gặp
Codex subagents có tự động chạy khi tôi chat không?
Không. Bạn phải chỉ định rõ ràng tên subagent trong prompt, ví dụ “Have the reviewer check this PR”. Codex không tự động spawn để tránh sử dụng tài nguyên ngoài ý muốn.
Tôi có thể tự tạo subagent mới ngoài bộ sưu tập này không?
Chắc chắn rồi, và repo này chính là tài liệu tham khảo tuyệt vời. Bạn chỉ cần tạo file .toml theo cấu trúc có sẵn, khai báo name, description, model và instructions. Sau đó copy vào thư mục agent là dùng được ngay.
Tôi nên dùng subagent toàn cục hay theo dự án?
Dùng toàn cục cho các vai trò chung như reviewer, debugger mà bạn muốn có mặt ở mọi repo. Dùng theo dự án cho các agent đặc thù như fintech-engineer chỉ liên quan đến một codebase cụ thể. Khi trùng tên, agent dự án sẽ được ưu tiên.
Các subagent có an toàn để chạy tự động trên CI không?
Nhiều subagent đã được đặt sandbox_mode read-only, phù hợp cho CI review. Tuy nhiên, repo không cam kết kiểm định bảo mật cho mọi agent, vì vậy bạn cần audit kỹ các file .toml trước khi tích hợp vào pipeline tự động.
Kết luận
Awesome Codex Subagents đóng gói hàng trăm giờ tinh chỉnh prompt thành những viên gạch TOML sẵn sàng nhét vào Codex CLI. Nó không biến Codex thành siêu nhân, nhưng giúp bạn biến một trợ lý chung chung thành một đội ngũ chuyên gia biết rõ việc của mình. Nếu bạn đã dùng Codex và muốn đi xa hơn, hãy clone repo, copy thử vài subagent vào dự án đang làm, rồi cảm nhận sự khác biệt khi review hay debug. Và nhớ, đọc kỹ file .toml trước khi chạy, vì “as is” vẫn là trách nhiệm của bạn nghen.
