stripe-best-practices skill 是什麼、怎麼安裝使用：Stripe 官方的支付接入決策指南（給 Claude Code / Codex 用）

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

這個 Skill 做什麼

大模型寫 Stripe 接入代碼，常見的問題是照着幾年前的教學寫：用已經不推薦的接口、全局設定密鑰、把發貨邏輯寫在支付成功的跳轉頁裏。stripe-best-practices 由 Stripe 官方維護，用來把智能體拉回當前的推薦做法。description：在開發與測試環境規劃、接口選擇（Checkout Sessions 還是 PaymentIntents）、Connect 平台搭建、帳單與訂閱、稅務、Treasury、從已棄用接口遷移以及安全實踐（密鑰管理、密鑰權限、Webhook、OAuth）上指導 Stripe 集成決策；規劃、構建、修改、測試或評審任何 Stripe 集成時使用。

SKILL.md 開頭直接給出當前最新的 API 版本和各語言 SDK 的最新版本號，要求預設使用最新版；這部分隨倉庫更新。接着是幾條預設立場：新集成用獨立的沙盒環境而不是帳戶共用的測試模式；推薦受限密鑰（rk_ 前綴）而不是完整權限的密鑰。

主體是一張集成路由表：一次性收款用 Checkout Sessions；需要內嵌的自定義表單用 Checkout Sessions 加 Payment Element；儲存支付方式用 Setup Intents；平台與市場用 Accounts v2；訂閱用 Billing 接口加 Checkout Sessions；稅務合規用 Stripe Tax 加登記接口，等等。

然後是關鍵規則，例如：開啟自動計稅前先確認已有有效的稅務登記，否則以為在收稅其實沒收；除線下終端外不要傳 payment_method_types，讓動態支付方式生效；不要把 Webhook 說成可選項，履約邏輯應放在 Webhook 處理函數里而不是成功頁；初始化客戶端實例來調用，不用已棄用的全局密鑰寫法。目錄裏有帳單、Connect、支付、安全、稅務、Treasury 六份參考。

怎麼安裝

stripe-best-practices 隨 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 按最新實踐接入支付）》。

怎麼用

• 「給這個 SaaS 加按月訂閱，帶 14 天試用」——它會先按路由表選接口，再寫代碼。
• 「評審現有的支付代碼，有沒有用到已棄用的寫法」。
• 「我們要做一個撮合平台，賣家收款、平台抽成，應該用什麼方案」。

適合誰 / 侷限

適合用 Stripe 收款的出海產品和獨立開發者。侷限：它是決策指引，不替代 Stripe 文檔；合規、稅務登記這類事需要你在 Stripe 後台和當地實際辦理；Stripe 對開戶地區和主體有要求，能否開通與技能無關。

注意事項

• 許可：MIT；Stripe 服務按其費率收費。
• 涉及真實資金：開發和測試一律在沙盒裏進行，SKILL.md 也建議優先使用權限受限的密鑰；不要把任何密鑰貼進對話或提交到倉庫。
• 技能裏寫的版本號是生成時的快照，以 Stripe 官方文檔為準。