{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Stripe Projects

通过 Stripe Projects 开通 SaaS 服务并同步凭据。

Skill 元数据
来源可选——使用 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
相关 skillstripe-link-cli、mpp-agent

参考：完整 SKILL.md

INFO

以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。

Stripe Projects Skill

封装 Stripe Projects CLI 插件，让 Hermes 能开通 SaaS 服务（Neon、Twilio、Vercel 等）、生成凭据并同步到用户的 .env，以及从一处跨提供商管理计费。

在 Windows 上更广泛的支付集群成熟之前，本 skill 限定 [linux, macos]。Stripe CLI 本身是跨平台的；这个门槛是集群的姿态，不是硬限制。

使用时机

触发短语：

  • "set up <provider>"、"provision <Neon|Twilio|Vercel|...>"、"create a database"
  • "give me a <Postgres|Redis|Twilio number|...> for this project"
  • "manage my stack credentials"、"rotate this key"、"upgrade my plan"
  • "what providers can I add?"

如果用户已有某提供商账户，本 skill 仍能用 stripe projects link <provider> 把它接进来。如果用户想用已有的提供商资源（例如已有数据库或 Vercel 项目），先查提供商支持情况；目前很多提供商支持开通新资源，但不支持导入已有资源。

前提条件

  • 已安装 Stripe CLI（macOS 用 Homebrew，Linux 用包管理器，或从 https://docs.stripe.com/stripe-cli/install 下载）
  • 已安装 Stripe Projects 插件
  • 一个 Stripe 账户。如果用户还没有，CLI 会在配置过程中引导其在浏览器登录或创建账户。

安装

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>     # 档位变更
stripe projects remove <provider>      # 注销
stripe projects rotate <provider>      # 轮换凭据

常见陷阱

  • .env 写入是真实写入。 CLI 会追加到项目根目录里现有的 .env。如果用户的 .env 被 gitignore（正常），键就安全落地；如果没有，本 skill 可能成为凭据泄露的途径。务必先检查 .gitignore。
  • 按项目隔离状态。 .projects/vault/vault.json 是按项目的。在两个不同项目里开通同一服务会创建两个独立资源——以及两张账单。
  • 计费发生在 Stripe 侧。 add/upgrade 过程中的档位提示是真实扣费；确认前向用户明示。
  • 提供商可用性会变。 catalog 会增长；如果用户点名的提供商没列出来，先 stripe projects catalog | grep <name>，而不是直接让 add 调用失败。
  • vault 里的凭据是加密的，但 .env 是明文。 标准 .env 卫生适用——永不提交它。
  • 移除服务并不总是销毁底层资源。 有些提供商留下一个暂停/休眠的资源。对高成本服务（尤其是托管数据库），remove 后去提供商自己的 dashboard 确认一下。

验证

stripe projects --version && stripe projects list

在已初始化项目内退出码 0 表示插件健康。