opencode-primitives

用途

每当 OpenWork 的行为直接基于 OpenCode 原语（技能、插件、MCP 服务、opencode.json 配置、工具/权限）实现时，都使用此技能。它以 OpenCode 官方文档为依据，并确保 UI 中的术语保持一致。

文档来源（相关时务必引用）

• 技能：https://opencode.ai/docs/skills
• 插件：https://opencode.ai/docs/plugins/
• MCP 服务：https://opencode.ai/docs/mcp-servers/
• 配置（opencode.json、位置、优先级）：https://opencode.ai/docs/config/

需要应用的关键信息

技能

• 技能文件位于 .opencode/skills/<name>/SKILL.md 或全局路径 ~/.config/opencode/skills/<name>/SKILL.md。
• 技能通过向上遍历至 git 工作树来发现，并加载 .opencode/ 或 .claude/skills/ 中所有匹配的 skills/*/SKILL.md。
• SKILL.md 必须包含 YAML frontmatter：name + description。
• 名称规则：使用小写字母和数字，以单个连字符分隔（^[a-z0-9]+(-[a-z0-9]+)*$），长度为 1-64，且必须与目录名称一致。
• 描述长度：1-1024 个字符。
• 访问权限由 opencode.json 权限（permission.skill 中的 allow/deny/ask）控制。

插件

• 本地插件位于 .opencode/plugins/（项目级）或 ~/.config/opencode/plugins/（全局）。
• npm 插件列在 opencode.json 的 plugin 下，并在启动时通过 Bun 安装。
• 加载顺序：全局配置、项目配置、全局插件目录、项目插件目录。

MCP 服务

• MCP 服务在 opencode.json 的 mcp 下定义，并使用唯一名称。
• 本地服务使用 type: "local" + command 数组；远程服务使用 type: "remote" + url。
• 可以通过 enabled 启用或停用服务。
• MCP 工具通过配置中的 tools 管理，其中包括 glob 模式。
• 远程服务的 OAuth 会自动处理；可以预先注册或禁用。

配置（opencode.json）

• 支持 JSON 和 JSONC。
• 优先级顺序：远程 .well-known/opencode -> 全局 ~/.config/opencode/opencode.json -> 自定义路径 -> 项目 opencode.json -> .opencode/ 目录 -> 内联环境变量覆盖。
• .opencode 子目录默认使用复数名称（agents/、commands/、plugins/、skills/、tools/、themes/），也支持单数名称以兼容旧版。

何时调用

• 添加或调整引用技能、插件、MCP 服务或 OpenCode 配置的 OpenWork 工作流。
• 设计涉及技能/插件安装、配置位置或权限提示的引导说明。
• 实现展示 OpenCode 原语的 UI（技能标签页、插件管理器、MCP 开关）。

用法

在实现或记录任何映射到 OpenCode 原语的 OpenWork 行为之前，调用 skill({ name: "opencode-primitives" })。