用途：为 OpenCode 配置和自定义专用 AI 助手，覆盖主智能体（可切换）与子智能体（由主智能体或 @ 调用），以适配不同开发工作流。
主要能力：内置 Build（全工具）、Plan（受限分析）、General（子智能体，多步任务）、Explore（只读代码库探索）。可配置 description、mode（primary/subagent/all）、model（provider/model-id）、temperature（0.0-1.0）、tools、permission（allow/ask/deny）、prompt、steps、hidden、color、top_p。工具与权限支持通配符，如 mymcp_* 与 git status *。
使用方式：在 opencode.json 的 agent 字段用 JSON 配置，或在 ~/.config/opencode/agents/ 与 .opencode/agents/ 下用 Markdown 加 YAML 前言创建；可用 opencode agent create 交互式创建。切换主智能体按 Tab，调用子智能体用 @ 提及，Leader+Right/Left 切换会话。
限制：color、model、temperature 必须写在 opencode.json，不要放进 Markdown 前言；Markdown 前言只应含 description、mode、tools、permission、steps、hidden 与系统提示词正文。具体收费、价格与平台支持暂未提供。参考文件包括 references/primary-agents.md、references/subagents.md、references/permissions.md，示例见 examples/custom-agents.md。