一、基本信息
| 项目 | 内容 |
|---|---|
| 名称 | connect-recommend(Stripe Connect 集成配置推荐 Skill) |
| 作者/维护者 | Stripe, Inc.(官方仓库 stripe/ai) |
| 来源链接 | https://github.com/stripe/ai/tree/main/skills/connect-recommend |
| 许可证 | MIT(GitHub API 确认,仓库根目录 LICENSE 文件核实) |
| GitHub Stars | 1,729(GitHub API 确认;为 stripe/ai 合集仓库整体数字,不代表本 Skill 单项热度,详见第六章说明) |
| Forks | 322(同为合集仓库整体数字) |
| 最新版本 | 无独立版本号;随仓库自动化“sync skills”流程持续更新,本技能目录最近一次同步提交为 2026-07-29 |
| 安装方式 | Claude Code / Codex 官方插件市场一键安装,或通用 npx skills add 命令,详见第十章 |
项目自述名称:仓库标题为「Stripe AI」(含 SDK、MCP Server 与多个 Agent Skills),本文聚焦其中的
connect-recommend技能。
二、功能介绍与亮点
connect-recommend 帮助开发者在动手写代码前,先把 Stripe Connect(多方支付/市场分账)的账户与费用配置想清楚——用户只需给一个公司网址或一句业务描述,技能就能推导出合适的方案:
- 自动业务研究:抓取用户提供的官网首页及
/about、/pricing等子页面,识别卖家/买家角色、资金流向、费用结构,并区分推断置信度(高/中/低),置信度不足的维度才会追问用户 - 代码库信号交叉验证:扫描现有项目里的
connected_account、transfer_data、application_fee_amount等既有 Stripe 代码模式,与业务研究结果互相佐证,发现矛盾会主动向用户澄清 - 结构化决策引擎:内置账户类型对照表、收费模式对照表、兼容性矩阵三份参考文件,把「Dashboard 归属 + 手续费承担方 + 坏账责任方 + 收款模式」组合成具体可执行的配置,并在生成前校验组合是否合法,避免推荐出互相冲突的配置
- 费用经济性检查:当平台费率明显偏低、且收费模式导致平台自身承担 Stripe 手续费时,会主动给出保证金/净利润预警,提示到 Stripe 定价页核对费率
- 产出可执行计划:最终生成一份 Markdown 格式的推荐方案文档,供后续对话或团队复用,而非仅在聊天记录里给一段建议
亮点:全程贯彻“一次一问、给编号选项、绝不用被动文字收尾”的交互纪律;技能本体(SKILL.md 约 21KB)加 8 份参考文件(决策矩阵、兼容性矩阵、账户类型、收费模式、话术规范等,合计逾 12 万字节),是本仓库内容最详尽的单个 Skill。
三、适用场景
所属分类:集成与工作流自动化
- 正在构建多方市场、平台型 SaaS、零工经济应用、订阅平台等需要把收款拆分给多个卖家/服务提供者的团队
- 需要在“平台自付手续费”还是“卖家自付手续费”、“平台统一托管账户”还是“卖家自行绑定 Dashboard”之间做技术选型,但不熟悉 Stripe Connect 各种账户配置组合的初中级开发者
- 已有 Stripe Connect 集成、想核对现有代码模式是否与业务模型匹配的团队
- 希望在写代码前先产出一份可评审、可存档的集成方案文档,而不是边写边试错的场景
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方 README:claude plugin install stripe@claude-plugins-official,安装即接入官方插件市场 |
| Codex | ✅ 原生支持 | 官方 README:codex plugin add stripe@openai-curated,属 OpenAI 官方精选插件目录 |
| OpenClaw | ❓ 未验证 | 公开材料未提及;技能遵循标准 SKILL.md 格式,理论上可安装,但未见官方或第三方验证 |
| Hermes Agent | ❓ 未验证 | 公开材料未提及针对本技能的适配,仅查到 stripe/ai 仓库另一技能 stripe-projects 有 Hermes 集成报道 |
五、推荐理由
多方分账(市场平台、零工经济、订阅分销)是 Stripe Connect 里最容易配置出错的部分——账户类型、手续费归属、坏账责任三个维度组合起来有几十种合法/非法搭配,选错往往要等到对账或纠纷发生时才发现。connect-recommend 把 Stripe 官方沉淀的决策逻辑做成一个会先做研究、会读代码、会做合法性校验的交互式推荐流程,用户给一个网址就能拿到一份可执行、可评审的配置方案,而不必自己啃官方文档里的账户类型矩阵。对用 Claude Code / Codex 搭建支付相关平台的初中级用户,这能省下大量前期选型时间,也降低“配置组合本身就不合法”这类隐蔽错误的概率。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Stripe 官方出品;仓库整体 1,729 stars,该数字属整个 stripe/ai 合集仓库,不代表本 Skill 自身热度 |
| 可用性 | 9 | 无需额外 CLI 或账号即可运行推荐流程(生成方案本身不要求已有 Stripe 账户);随官方插件市场一键装;文档极完整(21KB 主文件 + 8 份参考文件);本技能目录 2026-07-29 仍有提交 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单: ① 不执行 shell 命令,仅使用 Read(读参考文件/已有方案)与 Write(生成 Markdown 方案文档),权限范围明确 ② 会对用户主动提供的公司网址发起网页抓取以理解业务背景,联网目标透明(用户自己的网站),不外发到第三方 ③ 不要求 API Key 或任何凭据——推荐流程本身在接入真实 Stripe 账户之前即可完成 ④ 抓取的 SKILL.md 与全部参考文件均未发现可疑指令或 prompt injection 迹象 ⑤ 作者为 Stripe 官方,信誉极高 ⑥ License 明确(MIT) ⑦ 仓库整体活跃维护,本技能目录最近一次同步提交为 2026-07-29,无弃置风险
七、跟同类 Skills 相比的优势
| 技能 | 定位 | 与 connect-recommend 的差异 |
|---|---|---|
connect-recommend(本推荐) |
Stripe Connect 账户与分账配置的交互式推荐引擎 | 会先研究用户业务、扫描代码库,产出针对具体业务定制的配置方案,并做合法性校验 |
stripe-best-practices(同仓库姊妹技能) |
Stripe 全品类集成通用规范(支付、订阅、税务、安全) | 覆盖面更广,但以静态参考文档为主,不针对具体业务生成定制方案,也不做 Connect 专属的账户组合校验 |
stripe-apps(同仓库姊妹技能) |
Stripe Dashboard 扩展应用开发脚手架 | 解决的是“在 Stripe 后台里做一个可视化插件”,与“如何配置多方分账账户”是完全不同的问题域 |
connect-recommend 的核心差异化在于:它不是一份说明书,而是一个会主动研究、会追问、会校验合法性的决策工具,产出物是一份可复用的定制方案文档,这在同仓库乃至同类第三方集成技能中都不多见。
八、用户评价
该技能本身目前在第三方平台尚无独立的具名用户评价,公开渠道亦未查到专门针对 connect-recommend 的报道或讨论。
九、其他补充
同仓库 stripe/ai 下还包含 stripe-apps(Dashboard 扩展开发)、stripe-directory(第三方服务/供应商检索与采购)、stripe-docs(文档检索)、stripe-projects(第三方基础设施与凭据置备)、upgrade-stripe(API 版本升级指引)等姊妹技能,以及面向 LLM 框架的 @stripe/ai-sdk、@stripe/token-meter 两个 SDK 和一个官方托管 MCP Server(https://mcp.stripe.com),共同构成 Stripe 官方的 AI 集成工具体系。
十、安装使用方式
- Claude Code:
claude plugin install stripe@claude-plugins-official - Codex:
codex plugin add stripe@openai-curated - 通用手动安装:
npx skills add https://docs.stripe.com(注意:手动安装不会自动更新,需定期运行npx skills update -y) - 触发方式:安装后无需重启,在对话中描述“要做一个市场平台”“需要给多个卖家分账”等场景,或直接提供公司网址询问 Connect 该怎么配置时,Agent 会自动加载该技能并开始交互式推荐流程
十一、注意事项
- 推荐流程会读取用户主动提供的公司网址内容用于业务研判,若网址涉及内部/未公开信息,建议改用文字描述业务而非提供网址
- OpenClaw、Hermes Agent 的兼容性未获验证,如在这两个平台使用建议先做小范围测试
- 技能产出的是配置建议与方案文档,涉及真实资金流转与手续费计算,正式接入前仍建议由熟悉 Stripe Connect 的工程师人工复核
- 该技能是 Stripe AI 工具体系的一部分,仓库整体 1,729 stars 反映的是整个
stripe/ai仓库热度而非本 Skill 单项,实际效果请以自身场景验证为准