跳到主要內容

Stripe Projects

通過 Stripe Projects 配置 SaaS 服務並同步憑據。

技能元數據​

來源可選 — 使用 hermes skills install official/payments/stripe-projects 安裝
路徑optional-skills/payments/stripe-projects
版本0.1.0
作者Teknium (teknium1), Hermes Agent
許可證MIT
平臺linux, macos
標籤Payments, Stripe, Projects, Provisioning, Infrastructure
相關技能stripe-link-cli, mpp-agent

參考：完整 SKILL.md​

信息

以下是 Hermes 在觸發此技能時加載的完整技能定義。這是技能激活時代理所看到的指令。

Stripe Projects 技能

封裝 Stripe Projects CLI 插件，使 Hermes 能夠配置 SaaS 服務（Neon、Twilio、Vercel 等），生成並將憑據同步到用戶的 .env 文件中，並從一處管理跨提供商的計費。

在更廣泛的支付集群在 Windows 上成熟之前，限制為 [linux, macos]。Stripe CLI 本身是跨平臺的；此限制是針對集群的策略，而非硬性限制。

何時使用​

觸發短語：

  • “設置 <provider>”，“配置 <Neon|Twilio|Vercel|...>”，“創建數據庫”
  • “為此項目給我一個 <Postgres|Redis|Twilio number|...>”
  • “管理我的堆棧憑據”，“輪換此密鑰”，“升級我的套餐”
  • “我可以添加哪些提供商？”

如果用戶已經手動設置了服務並只想使用它，則此技能不是正確的入口點。

先決條件​

  • 已安裝 Stripe CLI（macOS 上使用 Homebrew，Linux 上使用包管理器，或從 https://docs.stripe.com/stripe-cli/install 下載）
  • 已安裝 Stripe Projects 插件
  • 擁有 Stripe 賬戶，並通過 stripe login 登錄

安裝​

macOS：

brew install stripe/stripe-cli/stripe
stripe plugin install projects

Linux：遵循 https://docs.stripe.com/stripe-cli/install 上特定於平臺的安裝說明，然後：

stripe plugin install projects

如何運行​

所有命令均從用戶的項目目錄內部通過 terminal 工具運行（CLI 會將 .env 和 .projects/vault/vault.json 寫入當前工作目錄）。

流程​

1. 初始化項目​

cd <project-root>
stripe projects init

這將創建 .projects/vault/vault.json（加密憑據存儲）並準備項目以接收提供商。

2. 發現可用的提供商​

stripe projects catalog

列出 Stripe Projects 支持的所有提供商——數據庫、託管、身份驗證、AI、分析、消息傳遞等。

3. 添加服務​

stripe projects add <provider>/<service>

示例：

  • stripe projects add neon/postgres
  • stripe projects add twilio/sms
  • stripe projects add runloop/sandbox

CLI 會在用戶的賬戶中向提供商配置服務，生成憑據，將其同步到 .env 中，並在 vault 中記錄資源。用戶可能需要確認層級選擇或定價提示。

4. 驗證​

stripe projects list

應顯示新添加的提供商及其 .env 鍵。

5. 管理 / 升級 / 移除​

stripe projects upgrade <provider>     # tier change
stripe projects remove <provider>      # deprovision
stripe projects rotate <provider>      # rotate credentials

陷阱​

  • .env 寫入是真實寫入。 CLI 會追加到項目根目錄中的任何 .env 文件。如果用戶的 .env 被 gitignore 忽略（正常情況），則密鑰會安全存放；如果沒有，此技能可能會成為憑據洩露的途徑。務必首先檢查 .gitignore。
  • 每個項目的狀態。 .projects/vault/vault.json 是每個項目獨立的。在兩個不同的項目中配置相同的服務會創建兩個單獨的資源——以及兩份賬單。
  • 計費發生在 Stripe 端。 add/upgrade 期間的層級提示是真實收費；在確認之前向用戶展示這些內容。
  • 提供商可用性會變化。 目錄在不斷增長；如果用戶命名的提供商未列出，請先執行 stripe projects catalog | grep <name>，而不是讓 add 調用失敗。
  • Vault 中的憑據是加密的，但 .env 是明文。 適用標準的 .env 衛生習慣——切勿提交它。
  • 移除服務並不總是銷燬底層資源。 某些提供商會留下暫停/休眠的資源。對於高成本服務（尤其是託管數據庫），在執行 remove 後檢查提供商自己的儀表板。

驗證​

stripe projects --version && stripe projects list

在已初始化的項目中，退出代碼 0 表示插件運行正常。