用途:为项目创建完整的 .opencode 目录结构,包含所需配置文件、agent 与 command,使团队可直接用 opencode serve 使用。官方说明强调一条通用原则:该技能只创建文件夹与结构;文中提到的 agent 类型(如 code-analyzer、documentation-writer)仅为示例,实际 swarm 的 agent 类型、用途与专长可以完全不同,因此适用于任意 agent 配置。
主要能力:生成基础或 swarm 就绪的目录结构。基础项目结构包含 .opencode/{agent,command} 与主配置文件 .opencode/opencode.json($schema 指向 https://opencode.ai/config.json,含 theme 与 autoupdate)。专用 agent 文件夹结构包含 AGENTS.md(agent 目录与通信协议)、.opencode/opencode.json、agent 下的主 agent 文件与 command 目录。它还给出通信协议模板,要求每个 agent 自报来自哪个文件夹与名称、联系原因、请求内容与回复格式。示例 agent 类型包括 data-scientist、ui-designer、api-developer、game-developer、researcher、translator、music-composer、financial-analyst 等,均仅为示范。
使用方式:通过命令行创建目录与写入文件,例如 mkdir -p .opencode/{agent,command},再用 cat > 配合 heredoc 写入 opencode.json 与 agent 的 markdown 文件。文档还提供开发项目模板,例如 code-reviewer agent 的 frontmatter 含 description、mode: subagent、tools(read、grep)与 permissions(edit: deny、write: deny)。
适用场景:需要快速搭建 OpenCode 项目骨架、组织多 agent 协作(swarm)与命令定义时使用。
限制与最佳实践:命名用 kebab-case;描述简洁;相关 agent 与 command 归组;对安全类 agent 限制写权限,仅在必要时允许 bash,并用具体命令权限而非通配符;配置始终带 $schema,敏感数据用环境变量,项目配置放 .opencode/,用户偏好放 ~/.config/opencode/;agent 应聚焦单一用途,专用任务用 subagent,主 agent 负责协调。资料未提供收费、价格、平台支持范围等细节。