> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> 使用官方 Dodo Payments 技能增强您的 AI 编程助手，实现无缝支付集成、Webhook 处理和计费流程。

## 概述

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

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

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

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

## 可用技能

| 技能                                                                                                                  | 描述                             |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| [dodo-best-practices](https://github.com/dodopayments/skills/tree/main/dodo-payments/best-practices)                | 综合指南，提供最佳实践下的 Dodo Payments 集成 |
| [webhook-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/webhook-integration)           | 设置和处理支付事件的 webhooks            |
| [subscription-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/subscription-integration) | 实现订阅计费流程                       |
| [checkout-integration](https://github.com/dodopayments/skills/tree/main/dodo-payments/checkout-integration)         | 创建结账会话和支付流程                    |
| [usage-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/usage-based-billing)           | 使用事件和计量仪实现按用量计费                |
| [billing-sdk](https://github.com/dodopayments/skills/tree/main/dodo-payments/billing-sdk)                           | 使用 BillingSDK React 组件         |
| [license-keys](https://github.com/dodopayments/skills/tree/main/dodo-payments/license-keys)                         | 管理数字产品的许可证密钥                   |
| [credit-based-billing](https://github.com/dodopayments/skills/tree/main/dodo-payments/credit-based-billing)         | 实现信用额度、余额和按信用计费扣除              |

## 安装

根据您选择的 AI 编程助手选择首选的安装方法。

<Tabs>
  <Tab title="Agent Plugin (recommended)">
    如果您使用 Claude Code、Codex CLI、Cursor 或 OpenCode，[Dodo Agent Plugin](/developer-resources/build-with-ai-coding-agents) 可以一步安装所有八个技能和两个 MCP 服务器。 当您的代理检测到相关任务时，技能会自动加载。

    请参阅 [AI Coding Agents guide](/developer-resources/build-with-ai-coding-agents) 以获取每个代理的安装命令。
  </Tab>

  <Tab title="Skills CLI">
    使用适用于任何 MCP 兼容代理的通用技能 CLI 安装技能：

    ```bash theme={null}
    # Install all Dodo Payments skills
    npx skills add dodopayments/skills
    ```

    或者按需安装单个技能：

    ```bash theme={null}
    # Best practices guide
    npx skills add dodopayments/skills/dodo-payments/best-practices

    # Webhook integration
    npx skills add dodopayments/skills/dodo-payments/webhook-integration

    # Subscription billing
    npx skills add dodopayments/skills/dodo-payments/subscription-integration

    # Checkout flows
    npx skills add dodopayments/skills/dodo-payments/checkout-integration

    # Usage-based billing
    npx skills add dodopayments/skills/dodo-payments/usage-based-billing

    # BillingSDK components
    npx skills add dodopayments/skills/dodo-payments/billing-sdk

    # License key management
    npx skills add dodopayments/skills/dodo-payments/license-keys

    # Credit-based billing
    npx skills add dodopayments/skills/dodo-payments/credit-based-billing
    ```

    <Tip>
      仅安装您需要的技能，以保持代理集中并减少上下文开销。
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    将 Dodo Payments 技能市场添加到 Claude Code：

    ```bash theme={null}
    /plugin marketplace add dodopayments/skills
    ```

    然后安装单个插件：

    ```bash theme={null}
    # Install best practices
    /plugin install dodo-best-practices

    # Install webhook integration
    /plugin install webhook-integration

    # Install subscription integration
    /plugin install subscription-integration

    # Install checkout integration
    /plugin install checkout-integration

    # Install usage-based billing
    /plugin install usage-based-billing

    # Install BillingSDK
    /plugin install billing-sdk

    # Install license keys
    /plugin install license-keys

    # Install credit-based billing
    /plugin install credit-based-billing
    ```
  </Tab>

  <Tab title="OpenCode">
    在 OpenCode 设置中配置技能时，它们会自动可用。 将 Dodo Payments 技能库添加到您的配置：

    ```json theme={null}
    {
      "skills": {
        "repositories": [
          "dodopayments/skills"
        ]
      }
    }
    ```
  </Tab>
</Tabs>

## 使用技能

安装完成后，当您要求 AI 助手实现 Dodo Payments 功能时，它可以利用这些技能。 这里有一些示例提示：

### 最佳实践

```
Help me integrate Dodo Payments into my Next.js app following best practices
```

### Webhooks

```
Set up webhook handlers for payment and subscription events
```

### 订阅

```
Implement a subscription flow with free trial and multiple pricing tiers
```

### 结账

```
Create a checkout session for my SaaS product
```

### 基于使用的计费

```
Add usage-based billing to track API calls for my AI product
```

### BillingSDK

```
Add a pricing page using BillingSDK components
```

### 许可证密钥

```
Implement license key validation for my desktop app
```

### 基于信用的计费

```
Set up credit entitlements and metered credit deduction for my AI product
```

## 技能的工作原理

技能为您的 AI 助手提供：

1. **程序知识** - 实现功能的分步说明
2. **代码模板** - 生产就绪的代码模式和片段
3. **最佳实践** - 安全性、错误处理和用户体验的推荐方法
4. **上下文感知** - 理解不同 Dodo Payments 功能如何协同工作

当您要求您的 AI 助手实现某个功能时，它会使用相关技能来：

* 理解正确的实现方法
* 生成准确的工作代码
* 遵循 Dodo Payments 约定
* 正确处理边缘案例和错误

<Note>
  技能与 [MCP Server](/developer-resources/mcp-server) 和 [Sentra](/developer-resources/sentra) 互为补充。 使用 MCP 进行 API 操作，使用 Sentra 进行引导集成，使用技能增强 AI 助手能力。
</Note>

## 与其他工具的比较

| 工具               | 目的         | 最适合                   |
| ---------------- | ---------- | --------------------- |
| **Agent Skills** | 增强 AI 助手知识 | 使用任何 MCP 客户端的 AI 辅助开发 |
| **MCP Server**   | 执行 API 操作  | 从 AI 助手直接访问 API       |
| **Sentra**       | 引导集成助手     | 在 IDE 中进行交互式计费集成      |

## 资源

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/dodopayments/skills">
    浏览源代码并为 Dodo Payments 技能做出贡献
  </Card>

  <Card title="MCP Server" icon="server" href="/developer-resources/mcp-server">
    使 AI 助手能够执行 Dodo Payments API 操作
  </Card>

  <Card title="Sentra" icon="wand-magic-sparkles" href="/developer-resources/sentra">
    为您的 IDE 提供 AI 驱动的计费助手
  </Card>

  <Card title="Discord Community" icon="discord" href="https://discord.gg/bYqAp4ayYh">
    获取帮助并与社区分享反馈
  </Card>
</CardGroup>