Specter

specter-skills

通过与 Claude 对话来构建游戏后端。

specter-skills 会教会 Claude 有关 Specter 的所有知识——这是一个 游戏后端平台——让你可以用日常语言为游戏添加玩家账号、游戏内经济系统、每日任务、 排行榜、锦标赛、战斗通行证和实时多人游戏，并获取正确、可用的代码，还能够无需打开 控制面板即可配置后端。

无需学习 SDK。无需阅读 API 文档。安装后直接提问。

You:    "Add Specter to my game — silent login, a coins wallet, and a daily
         quest 'play 3 matches' that rewards 100 coins."
Claude: ...writes the integration code, sets up the quest in your backend, done.

目录

• 包含内容
• 快速开始
• 安装
• 这些技能
• MCP 服务 · 设置 · 登录 · 工具 · 配置
• 可以向 Claude 提出的问题
• 查看版本和更新
• 要求
• 故障排除

包含内容

这个软件包包含同一产品的两个部分：

技能适用于 Claude Code、Claude Desktop、Claude Agent SDK 和任何其他支持技能的宿主。MCP 服务适用于任何兼容 MCP 的宿主（Claude Desktop、Claude Code 等）。

快速开始

1. 在你的游戏项目中安装技能：

npx specter-skills init

2. 从 console.specterapp.xyz 获取 API 密钥（Project → API Keys）。

3. 请 Claude 构建一些功能：

“为我的 Unity 游戏添加 Specter 邮箱登录和宝石货币。”

相应的技能会自动启用，Claude 随即编写集成代码。就是这么简单。

💡 想让 Claude 也为你设置后端（创建货币、任务、排行榜）？ 添加 MCP 服务，然后说 “在我的 Specter 项目中创建宝石货币和每日登录任务。”

安装

# Interactive — choose skills and where to install them
npx specter-skills init

# Install everything into this project's .claude/skills/
npx specter-skills install

# Install specific skills
npx specter-skills install specter specter-economy

# Install globally (available in all your projects)
npx specter-skills install --global

# Install into a custom directory (Agent SDK / other hosts)
npx specter-skills install --dir ./skills

技能会复制到 .claude/skills/（项目级）或 ~/.claude/skills/（全局）。它们是纯文件，可以提交到你的代码仓库。

技能

每项技能都包含简明指南和各端点参考（请求字段、响应示例），这些内容直接根据 Specter API 生成；此外，在适用时还提供可直接粘贴的 JavaScript / Unity 示例——确保 Claude 编写的代码准确无误。

MCP 服务

同一个软件包还附带 MCP 服务 specter-mcp，让 Claude 可以直接检查和配置 Specter 后端。技能向 Claude 介绍 API；MCP 服务则让它能够使用 API。

“我的项目有哪些货币？” · “我的设置正常吗？” · “创建一种宝石货币，以及一个奖励 100 枚金币的每日任务。”

设置

简便方式——运行 npx specter-skills init，它会询问是否为你完成设置（它会写入配置，无需编辑 JSON）。也可以随时运行：

# Claude Desktop
npx specter-skills mcp

# Claude Code (registers it for all your projects)
npx specter-skills mcp --code

然后重启 MCP 宿主，即可看到 specter 工具。（Claude Desktop 和 Claude Code 是配置各自独立的不同应用——请选择你实际使用的那个。）

{
  "mcpServers": {
    "specter": {
      "command": "npx",
      "args": ["-y", "-p", "specter-skills", "specter-mcp"],
      "env": {
        "SPECTER_ENV": "staging",
        "SPECTER_ALLOW_MUTATIONS": "true"
      }
    }
  }
}

只读工具可以立即使用；创建内容则需要一次性登录——无需配置 api-key 或项目 ID。

登录（无需密码）

要创建任何内容，Claude 都需要以你的身份操作——因此你只需通过浏览器授权一次。首次需要时，Claude 会运行 specter_login 工具（也可以在终端中自行运行）：

npx -y -p specter-skills specter-mcp login

操作步骤：

1. 浏览器会打开 Specter 控制面板。
2. 按照平常的方式登录——使用电子邮件 / 密码、Google 或 Apple。
3. 批准同意页面（“允许 specter-mcp 管理你的项目”）。
4. 完成——可撤销的令牌会保存在本地（~/.specter/credentials.json）。你将保持登录状态。

你的密码和社交账号凭据绝不会传给工具或 Claude。 你可以随时从控制面板撤销访问权限。使用 specter-mcp whoami 和 specter-mcp logout 管理会话。

ℹ️ 请在任意文件夹中运行 specter-mcp 命令，但不要在 specter-skills 源文件夹中运行（npx 在那里容易出错）。

工具

只读 — 始终可用，运行安全：

读取工具使用浏览器登录信息（运行一次 specter_login）——无需单独配置 api-key。

客户端 / 运行时 — 作为沙盒测试玩家，调用面向游戏的 /v2/client API，验证你的配置是否有效：

可修改 — 需选择启用（SPECTER_ALLOW_MUTATIONS=true），并须经你确认：

成就工具会为你解析易读名称——将 event 传入事件 slug/名称，将 rewards 传入 [{currency:"gems", quantity:50}]（或 item/bundle/marker），工具 会将其解析为正确的 ID。创建成就不会使其上线——请调用 specter_schedule_achievement 将其激活。

可修改工具会更改线上游戏配置，因此标记为非只读工具；你的 MCP 宿主会在每次调用前请求确认。请先将它们用于预发布项目。

系统会根据你的登录信息自动检测项目——无需查询项目 ID。（仅当 你的组织有多个项目且你想固定使用其中一个时，才设置 SPECTER_PROJECT_ID。）

配置

所有配置都通过 MCP 宿主配置中的环境变量完成：

可以向 Claude 提出的需求

安装后，只需描述你想要的功能——相应的技能（和 MCP 工具）会自动启动：

• “为我的游戏添加静默设备登录和金币钱包。”
• “设置一个每日任务：进行 5 场比赛 → 奖励 200 枚金币。在我的 Specter 项目中创建它，并提供客户端代码。”
• “创建一种高级宝石货币和一个新手商店，出售一件售价为 100 枚宝石的‘剑’道具。”
• “添加一个每周排行榜，并分发前 10 名的奖励。”
• “构建一个包含 30 个等级的战斗通行证。”
• “添加基于技能的匹配机制和队伍——告诉我需要处理哪些 WebSocket 事件。”
• “为什么我从 Specter 收到 429 错误？”
• “我的 Specter 项目配置正确吗？”

检查版本并更新

# Latest version published on npm
npm view specter-skills version

# Which skills you have installed (and their versions)
npx specter-skills list

# Update your installed skills to the latest
npx specter-skills update

npx 会缓存软件包约 24 小时。如果 update 获取的是旧版本，请使用 npx specter-skills@latest update 强制获取最新版本。MCP 服务（npx … specter-mcp）也会以相同方式始终获取最新发布版本。

要求

• Node.js 18+
• 一个 Specter 项目 + API 密钥（console.specterapp.xyz）
• 用于技能的 支持技能的 Claude 宿主（Claude Code、Claude Desktop 或 Agent SDK）；以及用于服务的 兼容 MCP 的宿主

故障排除

链接

• 🎮 控制台：console.specterapp.xyz
• 📦 npm：npmjs.com/package/specter-skills

npm version patch        # or minor / major
npm run generate         # refresh references
npm publish --access public