用途：指导创建 OpenCode AI 智能体，适用于需要为特定任务构建专用 AI 助手、配置智能体工具与权限的场景。不适用于 OpenCode 插件、斜杠命令或通用 AI 提示词。
文件位置：项目内为 .opencode/agent/<name>.md，全局为 ~/.config/opencode/agent/<name>.md。最小结构由 YAML frontmatter 加系统提示词正文组成，description 为必填字段。
可选字段：mode（primary、subagent、all，默认 all）、model、temperature（0.0-1.0）、prompt、maxSteps、tools、permission、disable。
模式：primary 为主助手，可用 Tab 键切换；subagent 由主智能体或 @ 提及调用；all 两者皆可。
工具：read、write、edit、bash、grep、glob、webfetch、websearch，可用布尔值启停，支持通配符批量禁用（如 mymcp_*: false）。权限可设为 ask、allow、deny，bash 支持按命令模式配置，例如 "npm test": allow、"git ": ask、"": deny。
温度建议：0.0-0.2 用于代码审查、调试、分析；0.3-0.5 用于一般开发与重构；0.6-1.0 用于文档与创意工作。
常见模式包括只读代码审查、后端开发、测试编写、文档编写等，均通过限制工具与权限实现最小授权。
最佳实践：命名用 kebab-case 并体现领域；提示词明确专业范围、关注点与规范；仅授予必要工具，对危险操作设权限限制，只读智能体禁用 bash，长任务可设 maxSteps。
PRPM 集成：可用 prpm.json 清单声明 format 为 opencode、subtype 为 agent，通过 prpm install @username/agent-name --format opencode 安装，prpm publish 发布。
使用：Tab 键切换主智能体，@ 提及调用子智能体，+Right/Left 导航父子会话。
限制与排错：智能体未找到需检查路径、扩展名与 YAML 语法；工具失效需核对工具名、权限与模式；效果不佳需细化提示词。具体收费、价格与平台信息暂未提供。