内容
# Stripe 专家技能
使您的助手成为 **全面 Stripe 专家** 的 AI 代理技能。涵盖收入分析、增长与预测、客户智能、财务与税务、欺诈、工程/集成和高级产品（Connect、基于使用量的计费）。为使用 **Cursor**、**Claude Code** 或任何 [Agent Skills](https://agentskills.io) 兼容助手的创始人、财务和工程团队构建。
<img width="2364" height="1576" alt="image" src="https://github.com/user-attachments/assets/62ea783c-ea25-4242-8772-9284e7cb25d0" />
由 [Stripe MCP 服务器](https://docs.stripe.com/mcp) 提供支持 - 您的代理直接从您的 Stripe 帐户读取实时订阅、发票和付款数据。
## 快速开始
**Stripe MCP** - 添加到 Cursor MCP 配置（[文档](https://docs.stripe.com/mcp)）：
```json
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}
```
在提示时通过 OAuth 进行身份验证。
**安装技能**
```bash
git clone https://github.com/appeeky/stripe-skills.git
cp -r stripe-skills/skills/* ~/.cursor/skills/
# 或项目级：.cursor/skills/
```
然后询问您的代理：
```
"我们的 MRR 是多少，活跃订阅数量是多少？"
"显示逾期订阅以及付款失败的原因"
"审计活跃订阅中预付费与借记卡"
"设置 Radar 规则以阻止预付费卡"
"我们的付款失败电子邮件流程是否已配置？"
"运行完整的 Stripe 计费健康检查"
```
**不想记住 35 个技能名称？**
```
/stripe-skill → 自动路由到正确的专家
```
## 技能（35）
### 路由器和基础
| 技能 | 功能 |
| --------------------------------------------------------- | ----------------------------------------------------------------------- |
| `[stripe-router](skills/stripe-router)` | **单一入口点** - 将任何计费问题路由到正确的技能 |
| `[stripe-billing-context](skills/stripe-billing-context)` | 创建 `stripe-billing-context.md` - 产品、Webhook、KPI 目标 |
### 收入和订阅
| 技能 | 功能 |
| ----------------------------------------------------------------- | ---------------------------------------------------------- |
| `[mrr-arr-snapshot](skills/mrr-arr-snapshot)` | MRR、ARR、按计划分类（分页、年度标准化） |
| `[active-subscriptions-audit](skills/active-subscriptions-audit)` | 按状态计数：活跃、试用、逾期、未付 |
| `[churn-analysis](skills/churn-analysis)` | 取消、自主与非自主流失信号 |
| `[subscription-plan-changes](skills/subscription-plan-changes)` | 升级、降级、比例调整、防重复计费 |
### 付款和恢复
| 技能 | 功能 |
| ------------------------------------------------------- | ------------------------------------------------------------- |
| `[past-due-dunning](skills/past-due-dunning)` | 逾期订阅、重试尝试、MRR 风险 |
| `[payment-failure-audit](skills/payment-failure-audit)` | 拒绝收费、失败原因、失败率 |
| `[card-funding-risk](skills/card-funding-risk)` | 预付费/借记卡/信用卡混合 - 虚拟卡流失模式 |
| `[email-dunning-setup](skills/email-dunning-setup)` | Stripe 计费电子邮件 + 自定义 `invoice.payment_failed` 流 |
| `[customer-portal-setup](skills/customer-portal-setup)` | 支付方式更新的门户配置 |
### 欺诈和定价
| 技能 | 功能 |
| --------------------------------------------------------- | --------------------------------------------- |
| `[radar-fraud-rules](skills/radar-fraud-rules)` | Radar 规则 - 阻止预付费、3DS、安全级别 |
| `[pricing-products-audit](skills/pricing-products-audit)` | 产品、价格、哪些计划推动收入 |
| `[coupon-promotion-audit](skills/coupon-promotion-audit)` | 优惠券、促销代码、折扣影响 |
### 运营
| 技能 | 功能 |
| ----------------------------------------------------------- | ------------------------------------------------------------- |
| `[checkout-conversion](skills/checkout-conversion)` | 结账会话完成 vs 放弃 |
| `[invoice-revenue-audit](skills/invoice-revenue-audit)` | 已付/开放/无法收款发票 - 现金收取 |
| `[webhook-reliability](skills/webhook-reliability)` | Webhook 事件、缺失处理程序、同步差距 |
| `[dispute-refund-audit](skills/dispute-refund-audit)` | 拒付、争议、退款 |
| `[payout-balance-report](skills/payout-balance-report)` | 余额、付款、净现金流 |
| `[stripe-health-dashboard](skills/stripe-health-dashboard)` | **完整计费健康检查** - 调整以上所有 |
### 增长和预测
| 技能 | 功能 |
| --------------------------------------------------- | -------------------------------------------------------- |
| `[revenue-forecasting](skills/revenue-forecasting)` | 预测 MRR/ARR 3/6/12 个月增长 + 流失 |
| `[cohort-retention](skills/cohort-retention)` | 保留率和收入保留率表格按注册 cohort |
| `[pricing-experiments](skills/pricing-experiments)` | 价格 A/B 测试、增加、 grandfathering、弹性 |
| `[upsell-expansion](skills/upsell-expansion)` | 扩展收入、NRR、附加/层级 upsell 机会 |
### 客户智能
| 技能 | 功能 |
| ------------------------------------------------------- | ------------------------------------------------------------- |
| `[customer-360](skills/customer-360)` | 完整的单个客户资料：LTV、付款健康、流失风险 |
| `[customer-segmentation](skills/customer-segmentation)` | 按计划/国家/资助/任期/价值细分 |
### 财务和会计
| 技能 | 功能 |
| ------------------------------------------------------------- | ---------------------------------------------------- |
| `[revenue-recognition](skills/revenue-recognition)` | 递延 vs 认可是收入、MRR-vs-现金、应计 |
| `[tax-compliance](skills/tax-compliance)` | Stripe 税、VAT/GST/销售税、税收覆盖 |
| `[financial-reconciliation](skills/financial-reconciliation)` | 付款 ↔ 银行对账单、费用明细 |
### 工程和集成
| 技能 | 功能 |
| --------------------------------------------------------------- | --------------------------------------------------------- |
| `[stripe-integration-review](skills/stripe-integration-review)` | 代码审计：幂等性、API 版本、竞争条件 |
| `[webhook-implementation](skills/webhook-implementation)` | 构建/修复 Webhook 处理程序、签名验证、幂等性 |
| `[checkout-implementation](skills/checkout-implementation)` | 构建 Checkout/Payment Element 流、客户重用 |
| `[stripe-security-audit](skills/stripe-security-audit)` | 密钥卫生、安全漏洞、PCI 范围、受限密钥 |
### 高级产品
| 技能 | 功能 |
| --------------------------------------------------- | --------------------------------------------------------- |
| `[stripe-connect](skills/stripe-connect)` | 市场付款、连接账户、应用程序费用 |
| `[usage-based-billing](skills/usage-based-billing)` | 计量计费、计量器、积分、超额层级 |
## 工作原理
```
您： "我们的 MRR 是多少，逾期订阅数量是多少？"
代理：
1. 读取 stripe-router → 路由到 mrr-arr-snapshot + past-due-dunning
2. 调用 Stripe MCP → 获取订阅（分页，所有页面）
3. 标准化年度计划为每月 MRR
4. 返回：MRR 表 + 逾期列表 + 推荐操作
```
## 安装
### Cursor
| 方法 | 命令 |
| ------------- | ------------------------------------------------ |
| 项目级 | `cp -r stripe-skills/skills/* .cursor/skills/` |
| 全局 | `cp -r stripe-skills/skills/* ~/.cursor/skills/` |
### Claude Code
```bash
npx skills add appeeky/stripe-skills
```
## 验证
```bash
./validate-skills.sh
```
## 相关
- [aso-skills](https://github.com/eronred/aso-skills) - 应用商店优化和增长技能
- [Stripe MCP 文档](https://docs.stripe.com/mcp)
由 [Appeeky](https://appeeky.com) 提供支持
## 许可证
MIT
