Xsolla AI Toolkit（xsolla-ai-kit）— 让 AI 编程助手一次接入游戏支付 API

技能简介

Xsolla AI Toolkit（仓库名 xsolla-ai-kit）是 Xsolla 官方开源的一套 Agent 技能包（Agent Skills），专为 AI 编程工具设计。它让 Claude Code、GitHub Copilot、Codex CLI、Cursor、Windsurf、Roo Code、Augment 等主流 AI 编程助手，能够直接、正确地接入 Xsolla 的支付与商业化 API，在游戏中集成支付能力，或搭建一个完全自主托管、前端可控的无头（Headless）网页商城。该技能包于 2026 年 8 月发布，采用 SKILL.md 开放标准，不含任何专有助手或引擎锁定，兼容开发者已经在使用的 AI 编程工具。

核心能力

• shop-setup 总编排技能：作为入口技能，负责规划整个商城构建范围，并串联调用各个领域技能，实现从零到可运行商城的完整流程。
• merchant-setup 商户配置：引导完成商户（Merchant）与项目（Project）的创建与配置，处理商户 ID、项目 ID 与 API Key 等核心凭据。
• headless-checkout-integration 无头支付集成：通过 Xsolla Headless Checkout 完成信用卡等支付方式的集成，支持沙盒环境测试支付。
• webhooks-impl 回调处理生成：自动生成 Webhook 处理器代码，处理支付成功、退款、订阅变更等异步事件通知。
• production 上线技能：指导从沙盒（Sandbox）环境切换到生产（Live）环境，完成正式上线前的各项检查。
• catalog-design 商品目录设计：规划商品、定价、虚拟货币、礼包组合等商城目录结构（规划中）。
• login-setup 登录鉴权：接入 Xsolla Login / NewID 认证体系（规划中）。
• 多工具适配：同时提供 AGENTS.md 通用上下文、.github/copilot-instructions.md（Copilot 专用）、.cursor/skills/（Cursor 原生技能）等多种适配形态。

安装配置

• Claude Code（插件市场安装）：在 Claude Code 中执行 claude plugin marketplace add xsolla/xsolla-ai-kit && claude plugin install xsolla-ai-kit@xsolla-ai-kit；或在会话内使用 /plugin marketplace add xsolla/xsolla-ai-kit 与 /plugin install xsolla-ai-kit@xsolla-ai-kit。
• Codex CLI：执行 codex plugin marketplace add xsolla/xsolla-ai-kit 完成安装。
• Cursor：将仓库添加为工作区文件夹（或以项目方式打开），Cursor 会自动从 .cursor/skills/ 加载技能，并有一条常驻规则指向这些技能。
• 无插件系统的工具（通用方式）：执行 git clone https://github.com/xsolla/xsolla-ai-kit，然后 cp -r xsolla-ai-kit/AGENTS.md xsolla-ai-kit/skills your-game-project/，凡遵循 AGENTS.md 约定的工具都会在下次打开项目时自动识别技能。
• 环境变量配置：安装后需配置 XSOLLA_MERCHANT_ID（商户 ID）、XSOLLA_PROJECT_ID（项目 ID）、XSOLLA_PROJECT_API_KEY（API 密钥），或直接运行 merchant-setup 技能引导完成。

使用步骤

1. 安装技能包：根据上面「安装配置」选择对应 AI 编程工具的安装方式，完成 xsolla-ai-kit 的安装。
2. 配置凭据：设置商户 ID、项目 ID 与 API Key 环境变量，或运行 merchant-setup 技能按引导创建商户与项目。
3. 描述你的需求：用自然语言向 AI 编程助手描述目标，例如「帮我集成 Xsolla Headless Checkout，并让我能在沙盒中用信用卡支付」，助手会自动匹配相应技能。
4. 指定入口技能（可选）：从 shop-setup 开始构建端到端商城；Claude Code 下可用 /shop-setup 斜杠命令（命名冲突时用 /xsolla-ai-kit:shop-setup）强制调用指定技能。
5. 按编排流程推进：shop-setup 会串联 catalog-design、login-setup、headless-checkout-integration、webhooks-impl、production 等技能，逐步完成从商品目录到上线发布的全部环节。
6. 验证与上线：在沙盒环境验证支付、回调等流程无误后，运行 production 技能切换到生产环境正式发布。

适用场景

• 独立游戏开发者接入支付：个人或小团队开发者无需深入研究 Xsolla API 文档，借助 AI 编程助手即可在游戏中快速集成支付与虚拟商品购买能力。
• 搭建自托管网页商城：为游戏搭建一个完全自主托管、前端样式与品牌完全可控的无头商城，无需依赖第三方商城模板。
• 游戏内购与虚拟货币体系：通过 catalog-design 设计虚拟货币、礼包、道具组合，构建完整的游戏内商业化体系。
• 支付回调与订单自动化：利用 webhooks-impl 生成的回调处理器，自动化处理支付成功、退款、订阅续费等事件，打通订单与后台系统。
• 新手接入 Xsolla 平台：不熟悉支付行业术语与集成路径的开发者，可通过技能包内已验证的生产级逻辑，一次性完成正确集成，避免「代码看起来对、上线就崩」的常见陷阱。

适用人群

• 游戏开发者与独立游戏团队
• 需要为产品接入支付能力的全栈工程师
• 使用 Claude Code / Copilot / Cursor 等 AI 编程工具的开发者
• 游戏商业化与运营负责人
• 希望自建无头商城的创业团队

工作原理

Xsolla AI Toolkit 采用 Agent Skills 开放标准，将 Xsolla 各领域的集成知识封装为一个独立的 SKILL.md 技能文件（每份 SKILL.md 对应一个 Xsolla 领域）。安装后，AI 编程助手会根据用户请求自动识别并加载对应技能；shop-setup 作为总编排技能，负责调用与串联其余领域技能，形成端到端流程。技能内部编码的是经过验证的、生产级的集成逻辑与正确调用路径，使 AI 首次生成的代码即可落地运行，并内建校验机制。同时，技能包通过 AGENTS.md 通用上下文、Copilot 专用 instructions、Cursor 原生技能目录等适配层，覆盖不同 AI 编程工具，实现「一次编写、多工具复用」，且不锁定任何专有助手。

官方链接

• GitHub 仓库：https://github.com/xsolla/xsolla-ai-kit
• 官网下载页：https://xsolla.com/ai-toolkit
• AGENTS.md 约定：https://agents.md