用途:该技能在任务涉及接入外部服务或第三方 API 时主动加载,引导从服务选型到生产部署的完整集成流程,强调类型安全、韧性、错误处理与测试。
主要能力:覆盖邮件服务(Resend、SendGrid、Postmark、AWS SES 等)、CMS(Sanity、Contentful、Payload、Strapi 等)、文件上传(UploadThing、Cloudinary、S3、Cloudflare R2 等)、分析与追踪(PostHog、Plausible、Google Analytics 等);支持配置第三方 webhook 端点、实现重试逻辑与熔断、在不碰生产 API 的前提下测试集成。资料还给出各服务选型决策树,包含免费额度与价格示例。
使用方式:技能提供分阶段流程。先做发现:用 discover 批量搜索 package.json 中的服务 SDK、.env.example 中的密钥、服务客户端与 webhook 路由,识别已有集成模式以保持一致。随后按需执行安装命令,例如 npm install resend、npm install @sanity/client @sanity/image-url、npm install uploadthing @uploadthing/react、npm install @aws-sdk/client-s3 @aws-sdk/s3-request-presigner,并创建对应客户端与接口代码,如 src/lib/email.ts、src/lib/sanity.ts、src/app/api/webhooks/sanity/route.ts、src/app/api/uploadthing/core.ts、src/lib/s3.ts。技能还建议用 React Email 编写模板、在 .env.example 记录环境变量,并附 service-patterns.md 与 validate-services.sh 参考资源。
适用场景:为应用添加发信、内容管理、文件上传、埋点分析或第三方回调;需要统一现有集成风格、加入重试与熔断、或在本地安全测试服务集成时。
限制:资料未提供该技能自身的安装方式、版本兼容范围与适用框架的完整列表;示例代码以 Next.js/TypeScript 为背景,其他技术栈的适配方式暂未提供。