Agent Skills
返回列表
Stripe 连接器

Stripe 连接器

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-oo-stripe 这个技能。

技能介绍

要解决什么问题

在自动化流程里操作 Stripe 账户,最常见的痛点是凭证管理和动作编排。直接调用 Stripe API,意味着自己保管 secret key、处理 token 过期与 scope 授权;裸调 SDK 则要手写每个请求的 payload 和错误分支。

这个技能把这件事收敛成一条命令:你只描述要做什么,凭证由 OOMOL 服务端注入,客户端永远不接触 raw token。

核心能力

围绕 Stripe 的三个核心对象提供 18 个动作:

  • 客户(Customer):create_customer、get_customer、update_customer、delete_customer,外加 list_customers 与 search_customers
  • 商品(Product):create_product、get_product、update_product、delete_product,外加 list_products 与 search_products
  • 价格(Price):create_price(一次性或订阅)、get_price、update_price,外加 list_prices 与 search_prices
  • identify_account 可确认当前 secret key 关联的账户

搜索类动作沿用 Stripe 原生的 search query 语法,不是另一套封装。

工作方式

每个动作的执行链路固定为三步:

  1. 查契约:先执行 oo connector schema 拿到该动作的权威 input/output schema,再构造 payload,不要凭文档猜字段
  2. 执行:用 --data 传入 JSON(对象字符串或 @path/to/file.json),省略则发送 {}
  3. 读结果:返回体形如 { "data": ..., "meta": { "executionId": "..." } },执行 ID 在 meta.executionId 下,可用于追踪

技能假设 oo CLI 已安装、账户已登录、Stripe 已连接,不要主动触发 oo auth login——只有命令真的报 auth 或连接错误时,才走一次性设置流程。

注意点与边界

  • 读操作(get / list / search)可直接运行;写操作(create / update)会改变 Stripe 状态,执行前需和用户确认 payload 与影响范围
  • 删除操作具有破坏性,必须确认目标对象并获得明确批准
  • 本技能覆盖 Stripe 的目录与客户管理,不涉及支付意图(PaymentIntent)、订阅结算等直接资金流转层面的能力
  • 首次连接采用 API key 方式授权;遇到 scope_missing、credential_expired 一类错误时需要重新连接

使用场景

  • 客服在工单里拿到客户 ID,需要查询该 Stripe 客户的资料与 metadata 以核实订单情况。
  • 产品团队发布新功能后,需要在 Stripe 后台创建对应的新产品和一次性或订阅价格。
  • 运营定期清理无效数据,需要按邮箱搜索 Stripe 客户并删除对应的空壳记录。
  • 财务核对站点定价时,需要列出当前所有处于活跃状态的 Price 确认计费规则是否生效。

适合人员

  • SaaS 后台开发者:需要在自动化流程里操作 Stripe 对象但不想自行保管 secret key。
  • 独立站运营:需要在不打开 Stripe 控制台的情况下批量创建商品和价格。
  • 财务对账人员:需要按条件搜索和列出 Stripe 客户与价格记录以核对账目。
  • 自动化工具维护者:希望把 Stripe 客户与目录操作封装成稳定可追踪的 Agent 技能。