remix-agent-publish

适用场景

当用户想通过 Agent、终端工作流或外部服务创建、上传、验证或检查 Remix 游戏时，使用此技能。

使用方法

• 对于基于终端的身份验证、配置、上传和分析工作流，优先使用 remix-cli 技能。
• 用户通过 MCP 客户端操作时，使用 remix-mcp-quickstart 技能。
• 阅读 remix-api-auth 技能了解身份验证设置。
• 生成 API 调用前，先获取 OpenAPI 规范：https://api.remix.gg/docs/json。
• 使用 remix-api-reference 技能了解工作流防护措施（但不要将其作为方法和路径的权威来源）。
• 对于 Phaser 构建，使用 phaser-2d-arcade 技能。
• 对于轻量级 3D 构建，使用 threejs-lite 技能。
• 生成或修复游戏代码时，使用 remix-game-sdk 技能。
• 使用 remix-submission-rules 技能了解验证要求。
• 遵循 remix-game-best-practices 技能，确保实现适合移动设备且与 SDK 兼容。
• 使用 remix-rest-snippets 技能查看客户端集成示例。
• 助手工作流使用 remix-mcp-quickstart 技能。

可用工作流

• remix-game-creation - 创建新的游戏草稿
• remix-upload-game - 上传版本代码
• remix-add-image - 生成图像并添加到游戏
• remix-add-sprite - 生成精灵图并添加到游戏
• remix-shop-items - 创建和管理游戏内商店道具
• remix-multiplayer - 启用多人游戏支持
• remix-save-game - 添加游戏状态的保存和加载功能
• remix-upload-asset - 上传图像、音频或 3D 模型，作为托管游戏资源

游戏设置

当前配置文件：

• 优先使用任务上下文或之前的工具结果
• .remix-cli.json 用于项目本地配置（gameId、versionId）
• 旧版 .remix-mcp.json 用于较早的项目
• ~/.config/remix/credentials.json 用于 CLI 凭据，MCP 也可重复使用这些凭据

重复使用现有 ID，不要凭空编造新 ID，也不要不加判断地调用 createGame。部分上游 MCP 文档仍提及 .remix-settings.json；若存在冲突，请优先采用当前打包的 MCP 技能和包源码。

内联验证

上传代码前，请按照 remix-submission-rules 技能中的验证清单逐项检查，以便尽早发现阻碍项。

REST API 工作流

所有游戏管理操作都通过对 https://api.remix.gg 发起 REST API 调用完成。通用流程如下：

1. 获取 OpenAPI 规范：https://api.remix.gg/docs/json
2. 根据规范确定准确的方法、路径和架构
3. 使用 API 密钥进行经过身份验证的 REST 调用
4. 检查响应中的成功或错误封装结构

详情请参阅 remix-rest-snippets 和 remix-api-reference 技能。

权威来源

当文档与运行时行为不一致时，以服务端 API 源码和 OpenAPI 文档为准：

• https://api.remix.gg/docs
• https://api.remix.gg/docs/json
• packages/cli/src/index.ts
• packages/mcp/src/core/tool-defs.ts
• packages/mcp/skills/SKILL.md
• packages/mcp/skills/workflows/*.md
• apps/server-api/routes/device-auth.ts
• @remix-gg/sdk（NPM 包）