跳转到主要内容
Agent Skills（智能体技能）是打包好的指令，AI 编程助手在您让它构建某项功能时会加载这些指令。针对每个核心使用场景，VelaFi Skills 会告诉助手按什么顺序调用哪些接口、需要避免哪些错误，以及如何检查结果。它们与 文档 MCP 服务器 互为补充：MCP 服务器让助手查阅文档，Skills 则告诉助手如何构建和验证集成。 这些 Skills 在 github.com/VelaFi-Tech/skills 开源，遵循开放的 Agent Skills 格式。
github.com/VelaFi-Tech/skills 是 VelaFi Agent Skills 唯一的官方来源。请勿从任何其他代码仓库、软件包或链接安装 VelaFi Skills 或插件，即使它们使用了 VelaFi 的名称。

​
安装

在终端中的 Claude Code 会话里，添加 VelaFi 插件市场并安装插件：
也可以在 shell 中执行相同的步骤：
该插件还会连接 VelaFi 文档 MCP 服务器（https://docs.velafi.com/mcp）。之后可通过 /plugin marketplace update 更新。

​
可用的 Skills

​
自检脚本

有两个 Skill 包含小型 Python 脚本，助手可以替您运行：
  • 令牌检查（velafi-api-setup）。使用环境变量中的沙盒凭证生成令牌，确认 API key、签名和 IP 白名单均配置正确。它只调用 GET /v2/token/generate；除非传入 --production，否则拒绝沙盒以外的任何主机；并且绝不会打印您的 secret 或完整令牌。
  • Webhook 端点自检（velafi-webhooks）。向您自己的本地 Webhook 端点发送已签名的测试事件，检查它是否验证签名、是否准确返回 {"callbackStatus":"SUCCESS"}、是否正确处理重复事件以及是否快速响应。它使用自己的测试密钥签名（您需要在开发环境中临时配置该密钥），且从不连接 VelaFi。沙盒环境不会发送 Webhook，因此上线前可以用它测试您的处理程序。

​
试一试

安装后，可以向助手提出例如：
  • “集成 VelaFi，让我们在墨西哥的客户通过 SPEI 付款，每个客户一个 CLABE。”
  • “为这个服务添加 VelaFi Webhook 端点，并在本地测试。”
  • “通过 VelaFi，用我们的 USDT 余额以 Pix 支付 BRL。”
  • “对这个代码仓库运行 VelaFi 上线检查。”

​
安全

  • Skills 中不包含任何凭证。它们要求助手将您的 API key 和 secret 保存在环境变量或密钥管理服务中，绝不写入代码或日志，并且只从您的服务器调用 VelaFi。
  • 助手默认使用沙盒环境，在调用生产环境或转移资金之前必须征得您的同意。
  • 构建什么始终由您掌控。上线前请检查生成的代码，并在沙盒环境中测试。
如需报告 Skill 的问题，请在 GitHub 仓库中提交 issue。Issue 是公开的，请勿包含 API key、secret、令牌、商户 ID 或交易详情。