• 人工智能
• AI 应用
• AI Agent
• 游戏开发
• 代码智能体
• 媒体生成

OhMyGame 是一款开源的 AI 游戏创作工作室，而它的插件系统正是让 AI 能力无限扩展的核心。本指南带你从零开始：理解 Skill 与 MCP 两种插件形态、写出第一个SKILL.md、接入 MCP 服务，并用内置的 AI 助手一键构建、验证、安装你的专属 OhMyGame 插件。无需深厚工程背景，跟着做即可上手。

一、插件是什么：Skill 与 MCP 双形态

在 OhMyGame 中，插件（Plugin）是安装能力的统一入口：你可以在同一个地方安装 Skill 与 MCP 服务、修改配置、测试连接、完成授权。一个插件包可以同时包含：

• 🧠Skill（技能）：一份份写给 AI 的"操作手册"，教会模型如何完成特定任务，例如 Phaser 2D 游戏开发、精灵图资产管线、Godot 工程操作等。Skill 可以附带脚本、参考资料和资源文件。
• 🔌MCP 服务：声明已存在的 STDIO 或 HTTP MCP 服务器，让 AI 通过标准协议调用外部工具（如 Godot MCP、第三方 API）。

仓库自带了丰富的原生插件，是最好的学习样本：

二、插件包结构速览：3 个文件就够用

一个最小插件包只需要.ohmygame-plugin/plugin.json清单文件，再按需添加 Skill 目录和 MCP 声明：

my-service/ ├── .ohmygame-plugin/plugin.json # 清单：名称、版本、能力声明 ├── skills/my-skill/SKILL.md # Skill 定义（可选） └── mcp.json # MCP 服务器声明（可选）

清单里最重要的字段：

• name（kebab-case 命名）、version（语义化版本）、description
• skills: "./skills/"—— 声明 Skill 目录
• mcpServers: "./mcp.json"—— 声明 MCP 配置文件
• configuration—— 用户可填写的配置项，支持text、secret、path、boolean、select五种类型
• interface—— 显示名、图标（预设图标或自定义 PNG/WebP，不超过 1 MB、2048×2048 像素）、适用项目类型（如web-game、godot-game）

💡 清单校验逻辑位于 src/shared/plugins.ts，版本兼容性判断（formatVersion、minimumHostVersion）在 src/daemon/plugin-contract.ts。所有路径都相对插件根目录、以./开头；不用的字段直接省略即可。

三、编写你的第一个 Skill 插件

Skill 的本质是一个带 YAML frontmatter 的 Markdown 文件，路径固定为skills/<skill-name>/SKILL.md：

--- name: web-game-studio description: Create complete browser games from short ideas, coordinating canvas design, visual mockups, art, implementation, and playtesting. --- # Web Game Studio Use this skill for new browser games...

frontmatter 中name和description是必填项——AI 创作流程在安装前会强制校验，缺失将导致安装失败。写法上遵循仓库内置的官方写作规则（src/daemon/plugin-authoring.ts）：

1. 写小而专注：描述"它做什么、什么时候用"，写模型自己不知道的可复用指引；
2. 按需添加支撑文件：可重复/易错的操作放脚本，条件性细节放references/，资源放assets/，并在正文中链接引用——参考 plugins/threejs-world/skills/threejs-world/ 的组织方式；
3. 使用包内相对路径，绝不引用构建器路径，保证插件可移植；
4. 不要重复造轮子：Skill 运行在游戏项目中，可直接使用宿主已启用的媒体工具与 Godot 连接。

一个优秀的范例是 plugins/web-game-studio/skills/web-game-studio/SKILL.md：它先让 AI 按create/feature/bugfix等模式分类任务，再按领域路由到 8 个专家 Skill，最后约定"保持预览命令可运行、iframe 内响应式"等宿主契约。

四、声明 MCP 服务与用户配置

在mcp.json中声明你要接入的 MCP 服务器，STDIO 与 HTTP 两种传输都支持：

{ "mcpServers": { "godot": { "command": "npx", "args": ["-y", "@coding-solo/godot-mcp@0.1.1"] } } }

这正是官方 Godot 插件 plugins/godot/mcp.json 的写法。要点：

• STDIO 服务用command+args（可加env），务必锁定包版本（如npx -y pkg@1.2.3）；HTTP 服务用url+headers；
• 配置值用${config.字段ID}插值引用，例如"url": "${config.endpoint}"、"Authorization": "Bearer ${config.api-key}"；
• 密钥永远声明为secret类型：用户填的值存入本地加密存储，任何配置 API 都不会回显，也绝不该写死在包文件里；
• 用户未填写的字段会让对应服务保持"未配置"，但不影响其他已配置的服务和 Skill。

配置项与服务器定义的完整字段模式定义在 src/shared/plugins.ts，MCP 宿主运行时（会话、OAuth、工具命名空间）实现在 src/daemon/plugin-mcp-host.ts。

五、三种创建与安装路径

路径 1：AI 助手一键构建（推荐新手）

在 Plugins 页面点击Create with AI，打开专属的 Plugin Builder 页面。它会包含一段对话和四个预览视图：Overview（概览）、Files（文件）、Setup（配置）、Checks（检查）。助手会在独立工作区中编写 Skill 与支撑文件，调用plugin_manage prepare校验草稿，你审阅后点击Install plugin完成安装；后续修改用Update plugin更新。每个工作区独立持久化，可随时恢复或删除。

路径 2：在游戏项目对话中直接开发

每个 Pi 智能体环境都会自动写入内置的plugin-creatorSkill（见 src/daemon/pi-agent.ts）。你只需在游戏项目对话中用自然语言描述需求，助手会创建插件目录并调用install_plugin工具完成校验与安装——校验规则与 AI 构建器完全一致。

路径 3：手工编写 + 文件夹安装

自己写好包结构后，通过Add plugin菜单从本地文件夹或 Git 仓库安装。安装器（src/daemon/plugin-installer.ts）会同时识别多种格式：原生.ohmygame-plugin/、Codex/Claude 插件清单，甚至约定俗成的skills/目录（发现逻辑见 src/daemon/plugin-discovery.ts）。导入的插件统一进入Personal分组，与官方Public分开展示，但共享同一套开关与配置体系。

六、检查、导出与常见注意事项

• ✅依赖检查：详情页的Check dependencies会读取 PATH、MCP 命令与工作目录，报告缺失工具、未锁定的npx版本和机器相关路径——注意它不会实际执行插件命令；
• 🔐连接测试使用隔离的临时 MCP 会话，只列出能力、不调用业务工具，用完即关；
• 📦导出与恢复：个人插件可导出为 ZIP（上限 50 MB），通过Add plugin → Import plugin archive恢复；导出会自动把敏感 MCP 字面量转成必填 secret 字段，但不包含平台凭据、OAuth 会话与 AI 对话历史，新环境需重新授权；
• ⚠️保持 ID 稳定：跨版本更新请固定插件名、配置字段 ID 与类型——宿主按插件 ID 保存用户配置，破坏性变更需要新的插件身份；
• 🚫范围边界：当前不支持在插件内生成全新 MCP 服务器、Pi 扩展、hooks 或自定义插件界面，请只复用已有的 MCP 服务。

七、延伸阅读

• 📖 官方插件文档（最全参考）：docs/plugins.md
• 🧪 端到端测试（凭据隔离、重启持久化、真实 STDIO/HTTP 工具发现与执行、OAuth 模拟）：test/plugin-capabilities.test.ts
• 🗂 预装插件清单示例：config/preinstalled-plugins.json
• 🎮 更多 AI 使用细节：docs/README.md

现在，打开你的 OhMyGame，用一句话描述你想象的插件——比如"给 Godot 项目加一套自动命名规范 Skill"——剩下的交给 AI 助手。你的第一个 Skill 插件与 MCP 服务，几分钟就能跑起来 🎮

• 人工智能
• AI 应用
• AI Agent
• 游戏开发
• 代码智能体
• 媒体生成