Codex Subagents

Source: https://github.com/VoltAgent/awesome-codex-subagents at 16f880a2a048
License: MIT
Read the English original

This edition is an AI-assisted translation.

精選收錄 13 個分類、175+ 個 Codex 子代理。

精選 Codex Subagents

本倉庫是 Codex Subagents（專為特定開發任務設計的專業 AI 助手）的權威收錄。內容專為 Codex 編寫，並與官方文件保持一致。

安裝

請嚴格按官方文件使用 Codex 自訂代理目錄：

• ~/.codex/agents/：全域代理（在所有專案中可用）
• .codex/agents/：專案級代理（在該倉庫中優先級更高）

1. 克隆本倉庫。
2. 將你需要的 .toml 代理檔案複製到上述某個目錄中。
3. 如有需要，重啟或重新整理你的 Codex 工作階段。
4. 在提示詞中明確委派任務（Codex 不會自動產生自訂子代理）。

範例：

mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/

mkdir -p .codex/agents
cp categories/04-quality-security/reviewer.toml .codex/agents/

如果你在 Codex 中使用代理設定，請將其放在 .codex/config.toml 的 [agents] 下，具體參見官方文件。

贊助商

	Crawlbase 是受到 70,000+ 開發者信賴的網頁資料基礎設施。其 Crawling API、MCP 伺服器與各類整合，讓 AI 代理能夠即時存取任意網頁——支援 JavaScript 渲染、代理輪換與反爬蟲防護。
	SerpApi 是面向 AI 應用的網頁搜尋 API。提供 Markdown 與 JSON 格式，便於各種整合。

👉 你可以在這裡展示你的產品，觸達使用 Claude Code、Codex、Gemini 等 AI 編程代理的開發者。

子代理儲存位置

Type	Path	Availability	Precedence
Project Subagents	.codex/agents/	Current project only	Higher
Global Subagents	~/.codex/agents/	All projects	Lower

注意：當發生命名衝突時，專案級子代理會覆蓋全域子代理。

子代理結構

每個子代理都使用 Codex 原生的 .toml 格式：

name = "subagent-name"
description = "When this agent should be invoked"
model = "gpt-5.6-luna"
model_reasoning_effort = "medium"
sandbox_mode = "read-only"

[instructions]
text = """
You are a [role description and expertise areas]...

[Agent-specific checklists, patterns, and guidelines]...
"""

智慧模型路由

每個子代理都包含一個 model 欄位，可自動將其路由到合適的模型——在品質與成本之間取得平衡：

Model	When It’s Used	Examples
gpt-5.6-sol	深度推理——架構評審、安全審計、金融邏輯	security-auditor、architect-reviewer、fintech-engineer
gpt-5.6-terra	實作、診斷、評估以及多步驟專業分析	docker-expert、test-automator、scientific-literature-researcher
gpt-5.6-luna	有界搜尋、抽取、路由、起草與輕量綜合	search-specialist、docs-researcher、agent-installer

沙箱模式理念

每個子代理的 sandbox_mode 欄位控制檔案系統存取權限：

• 唯讀代理（評審者、審計者）：sandbox_mode = "read-only"——只分析、不修改
• 工作區寫入代理（開發者、工程師）：sandbox_mode = "workspace-write"——可建立與修改檔案

分類

01. Core Development

日常編碼任務所需的核心開發子代理。

• api-designer - REST 與 GraphQL API 架構師
• backend-developer - 可擴展 API 的伺服器端專家
• code-mapper - 程式碼路徑梳理與所有權邊界分析
• design-bridge - 將 DESIGN.md 規範轉換為可實作的 UI 指令
• electron-pro - 桌面應用專家
• frontend-developer - 精通 React、Vue、Angular 的 UI/UX 專家
• fullstack-developer - 端到端功能開發
• graphql-architect - GraphQL schema 與聯邦架構專家
• microservices-architect - 分散式系統設計者
• mobile-developer - 跨平台行動端專家
• ui-designer - 視覺設計與互動專家
• ui-fixer - 針對已復現 UI 問題的最小安全修補
• websocket-engineer - 即時通訊專家

02. Language Specialists

具備深厚框架知識的特定語言專家。

• angular-architect - Angular 15+ 企業級模式專家
• cpp-pro - C++ 效能專家
• csharp-developer - .NET 生態專家
• django-developer - Django 4+ Web 開發專家
• dotnet-core-expert - .NET 8 跨平台專家
• dotnet-framework-4.8-expert - .NET Framework 傳統企業級專家
• elixir-expert - Elixir 與 OTP 容錯系統專家
• erlang-expert - Erlang/OTP 與 rebar3 工程專家
• expo-react-native-expert - Expo 與 React Native 行動開發專家
• fastapi-developer - 現代非同步 Python API 框架專家
• flutter-expert - Flutter 3+ 跨平台行動專家
• golang-pro - Go 並發專家
• java-architect - 企業級 Java 專家
• javascript-pro - JavaScript 開發專家
• kotlin-specialist - 現代 JVM 語言專家
• laravel-specialist - Laravel 10+ PHP 框架專家
• symfony-specialist - Symfony 應用與 Doctrine 專家
• nextjs-developer - Next.js 14+ 全端專家
• node-specialist - Node.js 後端專家
• php-pro - PHP Web 開發專家
• powershell-5.1-expert - Windows PowerShell 5.1 與完整 .NET Framework 自動化專家
• powershell-7-expert - 跨平台 PowerShell 7+ 自動化與現代 .NET 專家
• python-pro - Python 生態大師
• rails-expert - Rails 8.1 快速開發專家
• react-specialist - React 18+ 現代模式專家
• rust-engineer - 系統程式設計專家
• spring-boot-engineer - Spring Boot 3+ 微服務專家
• sql-pro - 資料庫查詢專家
• swift-expert - iOS 與 macOS 專家
• typescript-pro - TypeScript 專家
• vue-expert - Vue 3 Composition API 專家

03. Infrastructure

DevOps、雲端與部署專家。

• azure-infra-engineer - Azure 基礎設施與 Az PowerShell 自動化專家
• cloud-architect - AWS/GCP/Azure 專家
• database-administrator - 資料庫管理專家
• deployment-engineer - 部署自動化專家
• devops-engineer - CI/CD 與自動化專家
• devops-incident-responder - DevOps 事件管理
• docker-expert - Docker 容器化與最佳化專家
• incident-responder - 系統事件回應專家
• kubernetes-specialist - 容器編排大師
• network-engineer - 網路基礎設施專家
• platform-engineer - 平台架構專家
• security-engineer - 基礎設施安全專家
• sre-engineer - 網站可靠性工程專家
• terraform-engineer - 基礎設施即程式碼專家
• terragrunt-expert - Terragrunt 編排與 DRY IaC 專家
• windows-infra-admin - Active Directory、DNS、DHCP 與 GPO 自動化專家

04. Quality & Security — 測試、安全與程式碼品質專家（20 個代理）

04. Quality & Security

• accessibility-tester - A11y 合規專家
• ad-security-reviewer - Active Directory 安全與 GPO 審計專家
• anti-ui-slop-reviewer - 針對具體產品的 UI 完成度把關評審
• ai-writing-auditor - AI 寫作模式審計與重寫專家
• architect-reviewer - 架構評審專家
• browser-debugger - 基於瀏覽器的重現與客戶端除錯
• chaos-engineer - 系統韌性測試專家
• code-reviewer - 程式碼品質守護者
• compliance-auditor - 法規合規專家
• debugger - 進階除錯專家
• error-detective - 錯誤分析與解決專家
• gdpr-ccpa-compliance - GDPR 與 CCPA 隱私合規專家
• penetration-tester - 道德駭客專家
• performance-engineer - 效能最佳化專家
• powershell-security-hardening - PowerShell 安全加固與合規專家
• qa-expert - 測試自動化專家
• reviewer - 針對正確性、安全性與回歸的 PR 式評審
• security-auditor - 安全漏洞專家
• test-automator - 測試自動化框架專家
• ui-ux-tester - 詳盡 UI/UX 功能測試專家

05. Data & AI — 資料工程、機器學習與 AI 專家（14 個代理）

05. Data & AI

• ai-engineer - AI 系統設計與部署專家
• azure-databricks-platform-architect - Azure Databricks 平台與湖倉架構師
• data-analyst - 資料洞察與視覺化專家
• data-engineer - 資料管線架構師
• data-scientist - 分析與洞察專家
• database-optimizer - 資料庫效能專家
• llm-architect - 大型語言模型架構師
• machine-learning-engineer - 機器學習系統專家
• ml-engineer - 機器學習專家
• mlops-engineer - MLOps 與模型部署專家
• nlp-engineer - 自然語言處理專家
• postgres-pro - PostgreSQL 資料庫專家
• prompt-engineer - 提示詞最佳化專家
• reinforcement-learning-engineer - 強化學習與決策系統專家

06. Developer Experience — 工具鏈與開發者效率專家（14 個代理）

06. Developer Experience

• build-engineer - 建置系統專家
• cli-developer - 命令列工具建立者
• dependency-manager - 套件與依賴專家
• documentation-engineer - 技術文件專家
• dx-optimizer - 開發者體驗最佳化專家
• git-workflow-manager - Git 工作流與分支專家
• legacy-modernizer - 遺留程式碼現代化專家
• mcp-developer - Model Context Protocol 專家
• powershell-module-architect - PowerShell 模組與設定檔架構專家
• powershell-ui-architect - 面向 WinForms、WPF、Metro 框架與 TUI 的 PowerShell UI/UX 專家
• readme-generator - 零幻覺、維護者可直接使用的 README 生成器
• refactoring-specialist - 程式碼重構專家
• slack-expert - Slack 平台與 @slack/bolt 專家
• tooling-engineer - 開發者工具鏈專家

07. Specialized Domains — 特定領域技術專家（14 個代理）

07. Specialized Domains

• api-documenter - API 文件專家
• blockchain-developer - Web3 與加密專家
• embedded-systems - 嵌入式與即時系統專家
• fintech-engineer - 金融科技專家
• game-developer - 遊戲開發專家
• healthcare-admin - 醫療行政、收入週期與合規專家
• hipaa-compliance - 面向醫療 SaaS 廠商的 HIPAA 合規專家
• iot-engineer - IoT 系統開發者
• m365-admin - Microsoft 365、Exchange Online、Teams 與 SharePoint 管理專家
• mobile-app-developer - 行動應用專家
• payment-integration - 支付系統專家
• quant-analyst - 量化分析專家
• risk-manager - 風險評估與管理專家
• seo-specialist - 搜尋引擎最佳化專家

08. Business & Product — 產品管理與業務分析（17 個代理）

08. Business & Product

• assumption-mapping - 產品假設風險與驗證專家
• backlog-grooming - 敏捷待辦梳理專家
• business-analyst - 需求專家
• content-marketer - 內容行銷專家
• content-quality-editor - AI 內容品質與人性化專家
• customer-success-manager - 客戶成功專家
• growth-loops - 成長閉環與 PLG 機制專家
• legal-advisor - 法律與合規專家
• license-engineer - 軟體授權與合規系統專家
• product-manager - 產品策略專家
• project-manager - 專案管理專家
• resume-refiner - 履歷、CV 與 LinkedIn 檔案最佳化專家
• sales-engineer - 技術銷售專家
• scrum-master - 敏捷方法專家
• technical-writer - 技術文件專家
• ux-researcher - 使用者研究專家
• wordpress-master - WordPress 開發與最佳化專家

09. Meta & Orchestration — 代理協調與元程式設計（12 個代理）

09. Meta & Orchestration

• agent-installer - 透過 GitHub 瀏覽並安裝本倉庫中的代理
• agent-organizer - 多代理協調者
• codebase-orchestrator - 帶審批閘門的倉庫級重構治理
• context-manager - 上下文最佳化專家
• error-coordinator - 錯誤處理與恢復專家
• it-ops-orchestrator - IT 運維工作流編排專家
• knowledge-synthesizer - 知識聚合專家
• multi-agent-coordinator - 進階多代理編排
• performance-monitor - 代理效能最佳化
• pied-piper - 編排一組 AI 子代理來完成重複的 SDLC 工作流
• task-distributor - 任務分配專家
• workflow-orchestrator - 複雜工作流自動化

10. Research & Analysis — 研究、搜尋與分析專家（12 個代理）

10. Research & Analysis

• ab-test-analysis - A/B 測試解讀與發布/不發布決策
• cohort-analysis - 留存、隊列行為與激活指標分析
• competitive-analyst - 競爭情報專家
• data-researcher - 資料發現與分析專家
• docs-researcher - 基於文件的 API 與框架核驗
• first-principles-thinking - 挑戰假設、以第一性原理解決問題
• market-researcher - 市場分析與消費者洞察
• project-idea-validator - 嚴苛的想法壓力測試與可行/不可行策略師
• research-analyst - 綜合研究專家
• scientific-literature-researcher - 基於已發表科學研究的證據導向研究
• search-specialist - 進階資訊檢索專家
• trend-analyst - 新興趨勢與預測專家

11. AI Governance & Safety - 治理、護欄與可信 AI 專家（4 個代理）

11. AI Governance & Safety

• ai-governance-auditor - AI 治理控制與部署就緒評審
• model-risk-manager - 模型失效模式優先級排序與緩解專家
• policy-guardrail-designer - 提示詞、工具與工作流護欄設計者
• responsible-ai-reviewer - 公平性、濫用、透明度與監督評審

12. Platform Engineering & IDP - 內部開發者平台與黃金路徑專家（4 個代理）

12. Platform Engineering & IDP

• backstage-specialist - Backstage 目錄、模板與入口網站專家
• golden-path-designer - 強約束的自助服務工作流設計者
• idp-architect - 內部開發者平台架構專家
• platform-product-manager - 平台路線圖、採用與成功指標專家

13. LLMOps, Evals & Observability - 生產環境 AI 品質與執行時可觀測性專家（4 個代理）

13. LLMOps, Evals & Observability

• ai-observability-engineer - AI 原生鏈路追蹤、指標與日誌專家
• eval-engineer - 提示詞、工具與工作流評估專家
• hallucination-investigator - 事實性與上下文崩潰根因調查者
• prompt-regression-tester - 針對 AI 行為變化的回歸套件設計者

理解子代理

子代理是專業的 AI 助手，透過提供特定任務的專業能力來增強 Codex。它們如同專職幫手，在 Codex 遇到特定類型的工作時即可呼叫。

子代理有何特別之處？

獨立的上下文視窗 每個子代理都在自己隔離的上下文空間中運作，避免不同任務之間相互污染，並讓主對話執行緒保持清晰。

領域專屬智慧 子代理配備針對其專業領域精心編寫的指令，因此在特定任務上表現更優。

跨專案共享 建立子代理後，你可以在多個專案中復用，並分發給團隊成員，從而保持一致開發實踐。

明確委派 Codex 不會自動產生子代理。請使用明確委派提示詞，明確指定要產生哪些代理、如何拆分工作，以及期望的結果型態。

核心優勢

• 記憶體效率：隔離的上下文防止主對話被任務細節塞滿
• 更高準確率：專門的提示詞與設定在特定領域帶來更好的結果
• 工作流一致性：團隊級共享子代理確保常見任務採用統一方法
• Codex 原生：使用與官方 Codex 子代理文件一致的 .toml 代理檔案

範例工作流

PR 評審工作流：

Review this branch with parallel subagents. Have reviewer look for correctness, security, and missing tests. Have docs_researcher verify the framework APIs this patch depends on. Wait for both and summarize the findings with file references.

Bug 調查工作流：

Investigate the broken settings flow. Have code_mapper trace the owning code paths, browser_debugger reproduce the bug in the browser, and frontend_developer propose the smallest fix after the failure is understood. Wait for the read-heavy agents first, then continue.

倉庫探索與規劃工作流：

Use search_specialist to locate the code related to payment retries, knowledge_synthesizer to summarize the current design, and refactoring_specialist to propose a minimal refactor plan. Return a concrete action list.

AI 設計與建構生態工具

你用 AI 交付產品，但每次發布都因為沒人宣傳而悄然沉寂。EveryFeed 將你的 AI 助手接入一個社群工作區，可在 35+ 個頻道自動起草、排程並發布——無需代理公司，也無需僱用行銷人員。

貢獻

我們歡迎貢獻！相關規範請見 CONTRIBUTING.md。

• 透過 PR 提交新的子代理
• 改進既有定義
• 回報問題與 Bug

授權

MIT License - 見 LICENSE

本倉庫是由維護者與社群共同貢獻、精選整理的子代理定義合集。所有子代理均按「原樣」提供，不附帶任何擔保。我們不對任何子代理的安全性或正確性進行審計或擔保。使用前請自行審查，維護者不對因使用而產生的任何問題承担责任。

如果你發現所列子代理存在問題，或希望移除你的貢獻，請在本倉庫提交 issue，我們會盡快處理。