Agent Skills

概述

Agent Skills 是可复用的能力，可增强 AI 编程助手在处理 Dodo Payments 时的功能。它们提供流程知识和最佳实践，帮助 agent 更有效地完成特定任务，例如集成结账流程和设置基于用量的计费。

可以将 skills 理解为 AI 助手的插件。 它们会教会您的 agent 如何正确实现 Dodo Payments 功能，并遵循推荐的模式和最佳实践。

Skills 可与任何支持 skills protocol 的 AI agent 搭配使用，包括：

Claude Code — Anthropic 的 CLI 编程助手
Codex CLI — OpenAI 的 CLI 编程 agent
Cursor — AI 优先的代码编辑器
VS Code / GitHub Copilot — 通过 Agent Plugin 使用
Kiro — 将 skills 加载为 Power
OpenCode — 开源 AI 编程 agent
其他客户端 — 任何支持 skills protocol 的 agent

Gemini CLI 是个例外。 它没有 agent-skill 原语，因此无法在那里使用 skills——只能使用两个 MCP servers。

可用的 Skills

涵盖完整集成范围的十七项 skills，按照你正在执行的任务进行分组。

开始使用

Skill	Description
dodo-best-practices	SDK 设置、环境、API keys，以及从 canonical 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、test payment methods、webhook testing，以及 production launch checklist

接受付款

Skill	Description
checkout-integration	Checkout Sessions、payment links，以及 overlay 或 inline checkout
subscription-integration	Subscription 生命周期、trials、plan changes、proration 和 on-demand charges
mobile-checkout	适用于 React Native、Flutter、iOS 和 Android 的 in-app checkout
webhook-integration	使用 Standard Webhooks specification 接收和验证 webhooks

计费模式

Skill	Description
credit-based-billing	Credit entitlements、balances、ledger、rollover、overage 和基于 meter 的 deduction
usage-based-billing	Meters、event ingestion、aggregation 和 per-unit pricing
license-keys	License key activation、validation 和 instance management

Catalog 和定价

Skill	Description
product-catalog-management	Products、pricing、add-ons、collections、images 和 digital product delivery
discounts-and-promotions	Discount codes、eligibility rules、stacking 和 subscription-cycle limits
localized-pricing	Localized pricing、Adaptive Currency 和 purchasing power parity

客户和运营

Skill	Description
customer-management	Customers、self-service portal、saved payment methods 和 wallets
refunds-and-disputes	Issuing refunds、处理 disputes 和 chargebacks，以及协调 access

UI 和集成

Skill	Description
billing-sdk	用于 pricing tables 和 billing UI 的 BillingSDK React components
better-auth-integration	用于 customer sync、checkout 和 portal access 的 `@dodopayments/better-auth` plugin

安装

根据你的 AI coding assistant 选择偏好的安装方式。

Agent Plugin (recommended)
Skills CLI
Claude Code
OpenCode

Dodo Agent Plugin 可通过一个步骤，为 Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro 和 OpenCode 安装全部十七个 skills 以及两个 MCP servers。当您的 agent 检测到相关任务时，skills 会自动加载。请参阅 AI Coding Agents guide，了解各个 agent 的安装命令。

使用适用于任何支持 skills 的 agent 的通用 skills CLI 安装 skills：

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

或者根据需要安装单项 skills：

# Getting started
npx skills add dodopayments/skills/dodo-payments/dodo-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

仅安装所需的 skills，让您的 agent 专注于任务并减少上下文开销。

将 Dodo Payments skills marketplace 添加到 Claude Code：

/plugin marketplace add dodopayments/skills

然后安装单独的插件：

# 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 会从您指定的目录加载 skills。它不会扫描已安装的软件包，因此必须提供明确的 skills.paths 条目。使用 Agent Plugin package：

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

相对路径会相对于项目目录解析，因此该软件包必须位于该项目的 node_modules 中。也可以使用绝对路径，这样便无需本地安装。

不存在的 skills 路径会被静默忽略——不会报错，也不会发出警告。请确认 skills 确实已加载：

opencode run "List every skill available to you by name."

您应该会看到全部十七个。

使用 Skills

安装后，当您要求 AI 助手实现 Dodo Payments 功能时，它会自动加载相关 skill。您无需说出 skill 的名称，只需描述任务即可。

示例提示	加载的 Skill
遵循最佳实践，将 Dodo Payments 集成到我的 Next.js 应用中	`dodo-best-practices`
为我的 Hono 应用添加 Dodo Payments checkout 路由处理程序	`framework-adapters`
引导我测试支付并上线	`testing-and-go-live`
为我的 SaaS 产品创建 checkout session	`checkout-integration`
实现包含免费试用和多个定价层级的订阅流程	`subscription-integration`
为我的 React Native 应用添加应用内结账	`mobile-checkout`
为支付和订阅事件设置 webhook 处理程序	`webhook-integration`
为我的 AI 产品设置 credit entitlements 和按计量扣减 credit	`credit-based-billing`
为我的 AI 产品添加基于用量的计费，以跟踪 API 调用	`usage-based-billing`
为我的桌面应用实现 license key 验证	`license-keys`
创建包含附加组件和分层定价的产品目录	`product-catalog-management`
添加首三个计费周期优惠 20% 的 promo code	`discounts-and-promotions`
使用 purchasing power parity，以访客的本地货币显示价格	`localized-pricing`
为客户提供 self-service portal，以管理其支付方式	`customer-management`
发起部分退款，并在争议开启时撤销访问权限	`refunds-and-disputes`
使用 BillingSDK 组件添加定价页面	`billing-sdk`
将 Dodo Payments 接入我的 Better Auth 设置	`better-auth-integration`

Skills 的工作方式

Skills 会为您的 AI 助手提供：

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

当您要求 AI 助手实现某项功能时，它会使用相关 skill 来理解正确的实现方式，生成准确且可运行的代码，遵循 Dodo Payments 约定，并妥善处理边界情况和错误。

Skills 是对 MCP Server 的补充。使用 MCP 执行 API 操作，使用 Skills 增强 AI 助手的能力。

与其他工具的比较

工具	用途	最适合的场景
Agent Skills	增强 AI 助手的知识	使用任何支持 skills 的 agent 进行 AI 辅助开发
MCP Server	执行 API 操作	从 AI 助手直接访问 API

资源

Skills Repository

浏览源代码并为 Dodo Payments skills 做出贡献

MCP Server

让 AI 助手能够执行 Dodo Payments API 操作

Build with AI Coding Agents

安装 Agent Plugin：通过一个步骤安装全部 skills 和两个 MCP servers

Discord Community

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

概述

可用的 Skills

开始使用

接受付款

计费模式

Catalog 和定价

客户和运营

UI 和集成

安装

使用 Skills

Skills 的工作方式

与其他工具的比较

资源

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

​概述

​可用的 Skills

​开始使用

​接受付款

​计费模式

​Catalog 和定价

​客户和运营

​UI 和集成

​安装

​使用 Skills

​Skills 的工作方式

​与其他工具的比较

​资源

Skills Repository

MCP Server

Build with AI Coding Agents

Discord Community

概述

可用的 Skills

开始使用

接受付款

计费模式

Catalog 和定价

客户和运营

UI 和集成

安装

使用 Skills

Skills 的工作方式

与其他工具的比较

资源