stripe-best-practices

该 Skill 是一份专注于 Stripe 支付生态的知识型最佳实践指南，采用结构化的约束与决策体系为开发者提供架构级指导。其核心用法是通过关键词匹配用户意图（如订阅计费、平台分账、信用卡处理等），依据预设的「Never/Always/Preferences」规则给出精准的 API 选型建议。例如，当用户询问支付集成时，系统会优先推荐使用 Checkout Sessions 而非已废弃的 Charges API，倡导使用 Stripe-hosted Checkout 以确保 PCI 合规，并在 Connect 平台场景中指导选择合理的 charge 类型。

显著优点在于其内容严格锚定 Stripe 官方技术文档，所有参考链接均指向 stripe.com 域名，确保了技术建议的权威性与合规性。约束条件设计极具实用价值，明确列出了已弃用的技术债务（如 Sources API、Card Element、Tokens API 等），帮助开发者避免使用过时方案。决策逻辑清晰，能够根据具体业务场景（SaaS 订阅、市场平台、数据迁移等）快速输出最佳实践路径，显著降低架构设计阶段的决策成本。

潜在缺点主要集中在时效性与维护层面。Stripe API 持续迭代更新，而该 Skill 未明确标注内容最后更新时间，存在建议与最新 API 版本不一致的风险。作为纯静态知识库，它无法动态获取 Stripe 的最新功能发布或状态变更。此外，该 Skill 来源于个人开发者（T3），缺乏官方背书，长期维护的持续性存在不确定性，且未明确开源许可证。

适合的目标群体包括正在集成 Stripe 的后端开发工程师、支付系统架构师、SaaS 产品负责人以及需要处理复杂支付场景（如多方分账、订阅计费）的技术团队。特别适合那些希望快速了解 Stripe 最新集成范式、避免常见技术陷阱，但无暇深入研读全部官方文档的开发者。

使用该 Skill 需注意以下风险：由于 Stripe API 变更频繁，依赖静态知识库可能导致集成方案不符合最新合规要求；个人维护的文档更新可能滞后；该 Skill 仅提供决策建议，无法替代实际的代码实现、安全测试与生产环境验证。涉及支付卡数据（PAN）处理时，开发者必须自行确保 PCI DSS 合规。建议在关键业务决策前，务必与 Stripe 官方最新文档进行交叉验证，并在测试环境充分验证所有技术方案。