upgrade-stripe skill 是什麼、怎麼安裝使用：讓智能體按清單升級 Stripe API 版本和 SDK

本文根據 stripe/ai 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 7.1 萬次；所在倉庫 stripe/ai 在 GitHub 約 1865 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Stripe 的 API 按日期發佈版本，帳戶、SDK、每個 Webhook 端點各自可以釘在不同的版本上，升級時漏掉一處就可能出現「接口返回的結構變了，回調還是舊結構」這類問題。description：升級 Stripe API 版本、Webhook 端點、服務端 SDK、Stripe.js 和移動端 SDK 的指南。

SKILL.md 先講怎麼確定目標版本：你指定了就用你的；否則去 Stripe 文檔查當前版本。技能裏帶了一個「兜底版本號」，同時寫明它只是生成技能那天的快照——新的穩定版每月發佈，快照超過一個月大概率已經過時，只在訪問不了文檔時使用，並且不許猜測更新的版本號。動手前要把目標版本和項目裏每一處版本設定逐一對比：客戶端配置、單次請求的覆蓋、Webhook 端點；沒有明確要求時不把任何一處往舊版本改，也不把穩定版改成預覽版；沒能聯網核實就要如實說明「是否最新尚未確認」。

接着分章節解釋：

• 版本機制與變更類型；
• 服務端 SDK：Ruby、Python、Node 這類動態類型語言可以在配置裏覆蓋 API 版本；Java、Go、.NET 這類強類型語言的 SDK 版本與 API 版本綁定，要選對應的 SDK 版本；
• Stripe.js：如何加載帶版本的腳本、與 API 版本的配對、從 v3 遷移；
• 移動端 SDK：iOS、Android、React Native 及其與後端的兼容；
• Webhook：區分快照事件和精簡事件，後者的負載不帶版本，換 API 版本時不用動。

最後是九步升級清單（看變更日誌 → 看升級指南 → 更新 SDK → 改客戶端裏的版本參數 → 用 Stripe-Version 請求頭測試 → 逐個檢查事件接收端點 → 更新 Stripe.js → 更新移動端 SDK → 存儲對象 ID 的字段留足長度）。

怎麼安裝

upgrade-stripe 隨 Stripe 官方插件安裝（命令來自倉庫 README）：

bash
claude plugin install stripe@claude-plugins-official

Codex 用 codex plugin add stripe@openai-curated，Cursor 裏輸入 /add-plugin stripe。其他智能體可以用 npx skills add https://docs.stripe.com 手動安裝；README 提醒手動裝的技能不會自動更新，需要時運行 npx skills update -y。

倉庫整體介紹和其他安裝方式，詳見本站《stripe/ai 是什麼、怎麼安裝：Stripe 官方 Agent Skills 與 MCP（讓 Claude Code / Codex 按最新實踐接入支付）》。

怎麼用

• 「把這個項目的 Stripe 升級到當前最新的 API 版本，先列出所有釘了版本的地方」。
• 「只升級 Node SDK 的大版本，告訴我有哪些破壞性變更會影響現有代碼」。
• 「檢查我們的 Webhook 端點分別是什麼版本，哪些需要跟着升」。

適合誰 / 侷限

適合維護着一套跑了幾年的 Stripe 集成的團隊。侷限：它給流程和注意點，具體哪些字段變了仍要對照官方變更日誌；涉及支付的升級必須在沙盒裏完整迴歸，智能體改完代碼不等於升級完成。

注意事項

• 許可：MIT。
• 在測試環境裏升級和驗證，確認無誤再動生產配置；Webhook 端點的版本改動會立刻影響回調負載。
• 不要讓它憑印象填版本號，以它查到的官方頁面為準。