Agent Skills

概述

Agent Skills 是可重用的能力，增强 AI 编程助手在使用 Dodo Payments 时可以完成的操作。它们提供过程知识和最佳实践，帮助代理更有效地完成特定任务——从集成结账流程到设置基于使用情况的计费。

将技能视为 AI 助手的插件。 它们教会您的代理如何按照我们推荐的模式和最佳实践正确实施 Dodo Payments 功能。

Skills 可与任何 MCP 兼容的 AI 代理一起使用，包括：

Claude Code - Anthropic 的 CLI 编程助手
OpenCode - 开源 AI 编程代理
Cursor - 以 AI 为先的代码编辑器
其他 MCP 客户端 - 支持技能协议的任何代理

可用技能

涵盖完整集成范围的十七项技能，按您当前处理的任务进行分组。

入门

技能	描述
dodo-best-practices	SDK 设置、环境、API keys，以及从 checkout 到 webhook 的标准架构
framework-adapters	面向 Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun 和 Convex 的官方 `@dodopayments/*` route handlers
testing-and-go-live	Test mode、测试 payment methods、webhook 测试以及生产环境上线检查清单

接受付款

技能	描述
checkout-integration	Checkout Sessions、payment links，以及 overlay 或 inline checkout
subscription-integration	订阅生命周期、试用期、计划变更、按比例计费以及按需收费
mobile-checkout	适用于 React Native、Flutter、iOS 和 Android 的应用内 checkout
webhook-integration	使用 Standard Webhooks 规范接收和验证 webhooks

计费模式

技能	描述
credit-based-billing	Credit 权益、余额、ledger、结转、超额用量以及基于 meter 的扣减
usage-based-billing	Meters、事件摄取、聚合以及按单位定价
license-keys	License key 激活、验证以及实例管理

目录与定价

技能	描述
product-catalog-management	产品、定价、add-ons、collections、图片以及数字产品交付
discounts-and-promotions	Discount codes、资格规则、叠加使用以及订阅周期限制
localized-pricing	本地化定价、Adaptive Currency 以及购买力平价

客户与运营

技能	描述
customer-management	客户、自助服务门户、已保存的 payment methods 以及 wallets
refunds-and-disputes	发起退款、处理 disputes 和 chargebacks，以及重新核对访问权限

UI 与集成

技能	描述
billing-sdk	用于定价表和计费 UI 的 BillingSDK React components
better-auth-integration	用于客户同步、checkout 和 portal 访问的 `@dodopayments/better-auth` plugin

安装

根据您使用的 AI coding assistant，选择首选的安装方式。

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

如果您使用 Claude Code、Codex CLI、Cursor 或 OpenCode，Dodo Agent Plugin 可以一步安装全部十七项技能和两个 MCP servers。当您的 agent 检测到相关任务时，技能会自动加载。请参阅 AI Coding Agents 指南，了解各 agent 的安装命令。

使用适用于任何兼容 MCP 的 agent 的通用 skills CLI 安装技能：

# Install all Dodo Payments skills
npx skills add dodopayments/skills

或者根据需要单独安装技能：

# Getting started
npx skills add dodopayments/skills/dodo-payments/best-practices
npx skills add dodopayments/skills/dodo-payments/framework-adapters
npx skills add dodopayments/skills/dodo-payments/testing-and-go-live

# Accepting payments
npx skills add dodopayments/skills/dodo-payments/checkout-integration
npx skills add dodopayments/skills/dodo-payments/subscription-integration
npx skills add dodopayments/skills/dodo-payments/mobile-checkout
npx skills add dodopayments/skills/dodo-payments/webhook-integration

# Billing models
npx skills add dodopayments/skills/dodo-payments/credit-based-billing
npx skills add dodopayments/skills/dodo-payments/usage-based-billing
npx skills add dodopayments/skills/dodo-payments/license-keys

# Catalog and pricing
npx skills add dodopayments/skills/dodo-payments/product-catalog-management
npx skills add dodopayments/skills/dodo-payments/discounts-and-promotions
npx skills add dodopayments/skills/dodo-payments/localized-pricing

# Customers and operations
npx skills add dodopayments/skills/dodo-payments/customer-management
npx skills add dodopayments/skills/dodo-payments/refunds-and-disputes

# UI and integrations
npx skills add dodopayments/skills/dodo-payments/billing-sdk
npx skills add dodopayments/skills/dodo-payments/better-auth-integration

仅安装您需要的技能，让 agent 专注于当前任务并减少上下文开销。

将 Dodo Payments skills marketplace 添加到 Claude Code：

/plugin marketplace add dodopayments/skills

然后安装单独的 plugins：

# Getting started
/plugin install dodo-best-practices
/plugin install framework-adapters
/plugin install testing-and-go-live

# Accepting payments
/plugin install checkout-integration
/plugin install subscription-integration
/plugin install mobile-checkout
/plugin install webhook-integration

# Billing models
/plugin install credit-based-billing
/plugin install usage-based-billing
/plugin install license-keys

# Catalog and pricing
/plugin install product-catalog-management
/plugin install discounts-and-promotions
/plugin install localized-pricing

# Customers and operations
/plugin install customer-management
/plugin install refunds-and-disputes

# UI and integrations
/plugin install billing-sdk
/plugin install better-auth-integration

在 OpenCode 设置中完成配置后，技能会自动可用。将 Dodo Payments skills repository 添加到您的配置中：

{
  "skills": {
    "repositories": [
      "dodopayments/skills"
    ]
  }
}

使用技能

安装后，当您要求 AI coding assistant 实现 Dodo Payments 功能时，它会自动加载相关技能。您无需指定技能名称，只需描述任务即可。

示例提示词	加载的技能
按照最佳实践，帮助我将 Dodo Payments 集成到我的 Next.js 应用中	`dodo-best-practices`
为我的 Hono 应用添加 Dodo Payments checkout route handler	`framework-adapters`
带我完成 payment 测试和正式上线	`testing-and-go-live`
为我的 SaaS 产品创建一个 checkout session	`checkout-integration`
实现带免费试用和多个定价层级的订阅流程	`subscription-integration`
为我的 React Native 应用添加应用内 checkout	`mobile-checkout`
为 payment 和 subscription 事件设置 webhook handlers	`webhook-integration`
为我的 AI 产品设置 credit 权益和基于 meter 的 credit 扣减	`credit-based-billing`
为我的 AI 产品添加基于用量的计费，以跟踪 API 调用	`usage-based-billing`
为我的桌面应用实现 license key 验证	`license-keys`
创建包含 add-ons 和分层定价的产品目录	`product-catalog-management`
添加一个首三个计费周期优惠 20% 的 promo code	`discounts-and-promotions`
使用购买力平价，以访问者的本地货币显示价格	`localized-pricing`
为客户提供用于管理 payment methods 的自助服务门户	`customer-management`
发起部分退款，并在 dispute 开启时撤销访问权限	`refunds-and-disputes`
使用 BillingSDK components 添加定价页面	`billing-sdk`
将 Dodo Payments 接入我的 Better Auth 设置	`better-auth-integration`

技能的工作方式

技能为您的 AI coding assistant 提供：

流程知识 - 实现功能的分步说明
代码模板 - 可用于生产环境的代码模式和代码片段
最佳实践 - 关于安全性、错误处理和 UX 的建议方案
上下文感知 - 理解不同 Dodo Payments 功能如何协同工作

当您要求 AI coding assistant 实现某项功能时，它会使用相关技能来：

理解正确的实现方式
生成准确且可运行的代码
遵循 Dodo Payments 约定
正确处理边界情况和错误

技能可以补充 MCP Server 和 Sentra。使用 MCP 执行 API 操作，使用 Sentra 获取引导式集成，并使用技能增强 AI coding assistant 的能力。

与其他工具的比较

工具	用途	最适合
Agent Skills	增强 AI coding assistant 的知识	使用任何 MCP client 进行 AI 辅助开发
MCP Server	执行 API 操作	AI coding assistant 的直接 API 访问
Sentra	引导式集成 assistant	IDE 中的交互式计费集成

资源

Skills Repository

浏览源代码并为 Dodo Payments 技能贡献内容

MCP Server

让 AI coding assistant 能够执行 Dodo Payments API 操作

Sentra

面向 IDE 的 AI 驱动计费 assistant

Discord Community

获取帮助并与社区分享反馈

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

概述

可用技能

入门

接受付款

计费模式

目录与定价

客户与运营

UI 与集成

安装

使用技能

技能的工作方式

与其他工具的比较

资源

Skills Repository

MCP Server

Sentra

Discord Community

​概述

​可用技能

​入门

​接受付款

​计费模式

​目录与定价

​客户与运营

​UI 与集成

​安装

​使用技能

​技能的工作方式

​与其他工具的比较

​资源

Skills Repository

MCP Server

Sentra

Discord Community

概述

可用技能

入门

接受付款

计费模式

目录与定价

客户与运营

UI 与集成

安装

使用技能

技能的工作方式

与其他工具的比较

资源