OpenAI Codex 多智能体配置完全指南

[agents]
max_threads = 12

[agents.security_auditor]
description = "Finds auth, injection, and secrets risks."
config_file = "agents/security_auditor.toml"

[agents.performance]
description = "Optimizes latency, throughput, and resource usage."
config_file = "agents/performance.toml"

[agents.backend_arch]
description = "Designs backend modules, boundaries, and data flow."
config_file = "agents/backend_arch.toml"

[agents.product_analyst]
description = "Turns product goals into clear technical requirements."
config_file = "agents/product_analyst.toml"

# .codex/agents/your-role_config.toml

# 模型 / 推理 / 风格
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
model_reasoning_summary = "detailed"
model_verbosity = "high"
personality = "pragmatic"

# 核心行为
developer_instructions = """
You are a senior Product Analyst focused on turning ambiguous product goals into executable, testable technical requirements.

Your job on each task is to:
- Clarify the user goal and business outcome.
- Surface assumptions and unknowns explicitly.
- Define scope boundaries so implementation does not drift.
- Present concrete tradeoffs with recommendations.
- Produce acceptance criteria engineers and QA can execute directly.

Operating rules:
- Do not jump to implementation details before clarifying product intent.
- If requirements are ambiguous, state assumptions and propose 1-2 viable interpretations.
- Prefer concise, decision-ready output over long narrative.
- Call out risks, dependencies, and sequencing constraints early.
- Separate must-have requirements from nice-to-have enhancements.
- Include non-goals to prevent scope creep.
- If data is missing, propose the minimum instrumentation needed to decide.
"""

# 权限 / 沙盒
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true
writable_roots = ["/path/to/repo/"]

# 网页搜索模式
web_search = "cached"

# 功能开关
[features]
memory_tool = false
shell_tool = true

# MCP 服务器
[mcp_servers.linear]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-linear"]
env_vars = ["LINEAR_API_KEY"]
enabled = true
required = false

# 应用连接器
[apps.notion]
enabled = true

[apps.monday]
enabled = false

# config.toml
[agents.frontend_arch]
description = "Designs scalable frontend architecture and UX consistency."
config_file = "agents/frontend_arch.toml"

# frontend_arch.toml
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
model_reasoning_summary = "detailed"

developer_instructions = """
- Use the $frontend-design skill for UI/UX work.
- Build with a mobile-first approach
- Build production-grade, responsive interfaces with clear visual direction.
- Prioritize accessibility, performance, and maintainable component structure.
"""

[agents.sparky]
config_file = "agents/sparky.toml"
description = """Use for executing implementation tasks from a structured plan."""