Stripe 版本升级指南
帮助开发者安全升级 Stripe API、服务端 SDK、Stripe.js 与移动 SDK。
内容主要提供版本升级建议和代码示例，没有明显恶意行为或破坏性默认操作；示例使用测试密钥占位符，并提示显式指定版本。但未说明密钥管理、敏感数据流、升级前用户确认、回滚方案或依赖安全，因此扣分。
文档结构一致，覆盖 API、服务端 SDK、Stripe.js、移动 SDK 和升级清单；但没有该技能专属测试、版本兼容矩阵、异常输入处理或失败诊断信息。静态评估且无可复现实验证据，按上限保守给分。
目标场景较清晰，覆盖多种 Stripe 客户端和渐进式升级；但没有明确输入、输出、触发条件、非适用范围或环境限制，也未提供中文支持和中国大陆网络可达性说明，因此扣分。
文档可读，包含分层说明、示例、升级清单、官方文档链接；仓库提供 MIT 许可证、同步机制和安全报告路径。但技能本身缺少安装说明、变更记录、明确维护责任、版本策略和故障排查，发布者身份也未获验证。
升级清单和版本配置示例可直接辅助常见升级任务，且包含 webhook、测试头和对象 ID 等实务提醒；但不能替用户分析具体代码差异、验证迁移结果或提供完整回滚方案，静态证据不足以超过保守上限。
引用了 Stripe API changelog、升级指南和 SDK 文档等可审计的一手材料，仓库也有通用 CI；但没有覆盖该技能关键路径的专属测试或第三方执行证据，结论主要依赖文档陈述，因此扣分。
- “最新”API 版本是时效性声明，升级前应以当前官方 changelog 和升级指南复核。
- 示例包含 Stripe 密钥占位符，但未说明生产环境密钥保管、轮换或日志脱敏。
- 文档建议测试和逐步升级，却未定义验收标准、回滚步骤或针对具体代码库的迁移验证。
- 未说明中国大陆网络访问 Stripe 文档、Stripe API 或相关 CDN 的可达性与替代方案。
它能做什么 & 适用场景
该技能专门指导 Stripe API 版本和各类 SDK 的升级。内容覆盖变更分类、动态类型与强类型服务端 SDK、Stripe.js、iOS、Android 及 React Native。它建议以最新的 2026-06-24.dahlia API 版本为目标，除非用户指定其他版本。指南还提供变更检查清单、测试方式和 Webhook 兼容性注意事项。
它识别 Stripe API 的向后兼容变更与破坏性变更，指导用户查阅 API Changelog 和升级指南，更新服务端 SDK、apiVersion、Stripe.js 与移动 SDK，并检查 Webhook 事件结构。它提供 Python、Ruby、JavaScript、curl 等配置和测试示例，也说明强类型语言应通过升级 SDK 匹配目标 API 版本。
- 使用 Python、Ruby、PHP 或 Node.js 的开发者，需要显式指定新的 Stripe API 版本。
- 使用 Java、Go 或 .NET 的团队，需要通过升级 SDK 迁移到新的 API 版本。
- 维护 Stripe.js 集成的前端开发者，需要在 Acacia、Basil、Clover 或 Dahlia 版本之间迁移。
- 维护 iOS、Android 或 React Native 支付应用的团队，需要规划移动 SDK 升级。
- 需要在不改变默认版本的情况下，用 Stripe-Version 请求头测试新 API 版本的工程师。
- 升级后需要检查 Webhook 新事件类型和事件结构的 Stripe 集成维护者。
优缺点一览
- 同时覆盖 API、服务端 SDK、Stripe.js 和移动 SDK。
- 区分动态类型与强类型语言的升级方式。
- 提供明确的升级清单和 Stripe-Version 测试示例。
- 提醒处理 Webhook 新事件类型、事件结构和最长 255 个字符的对象 ID。
- 内容是升级指导，不包含自动迁移脚本或测试套件。
- 没有展示具体产品领域变更的逐项迁移方案。
- 未提供仅安装该单个技能的官方命令。
- 示例覆盖的语言和平台有限，不能据此确认其他环境的适配情况。
如何安装
该仓库包含 24 个技能。按 README 的手动安装方式，在项目中运行：npx skills add https://docs.stripe.com。手动安装的技能不会自动更新，可运行 npx skills update -y。README 未提供仅安装 upgrade-stripe 单个技能的命令。
如何使用
将技能放在 Agent Skills 客户端可识别的 skills/upgrade-stripe/SKILL.md 路径下，然后向代理提出具体请求，例如：“将我的 Stripe 集成升级到 2026-06-24.dahlia，并列出需要检查的 SDK、Stripe.js 和 Webhook 变更。”