用途:该技能用于创建和优化 OpenCode 智能体,采用对话式引导问答,而非一次性输出配置。适合创建新智能体、改进智能体表现或设计配置。
主要能力:先询问核心任务、触发条件与人设,再调研领域现状,随后确定权限、技能与模式,最后展示草稿并按反馈迭代。要求不假设用户意图,须主动提问;用户可跳过不关心的配置。
配置要点:智能体可放在项目 .opencode/agent/<name>.md 或全局 ~/.config/opencode/agent/<name>.md。支持 model、mode(subagent 可隐藏)、permission 等字段。权限需明确询问;标准权限不额外列出 bash、read、write、edit,非标准访问才显式配置。技能权限始终用 "*": "deny" 加显式 allow。旧版 tools:、maxSteps: 需改为 permission:、steps:。
description 字段决定触发:主智能体保持极简(约 3 词),其他智能体需具体并含触发示例。系统提示建议使用角色、指令、工作流、输出格式、示例结构,推荐 XML 标签提升清晰度。对使用工具循环的智能体,可加入持久性、工具使用、规划等提醒。
改进流程:通过“哪里不好用”“能举例失败情况”“本该怎么做”诊断,再针对描述过宽/过窄、提示含糊、权限过松、技能未限制等提出修复,并在应用前征求确认。
限制:资料未提供价格、平台支持范围、具体效果保证或完整 schema 细节,相关配置应参考其 references/opencode-config.md 与 references/agent-patterns.md。