跳到主要内容

Stripe Projects

通过 Stripe Projects 配置 SaaS 服务 + 同步凭证。

Skill 元数据​

来源可选 — 使用 kopi skills install official/payments/stripe-projects 安装
路径optional-skills/payments/stripe-projects
版本0.1.0
作者Teknium (teknium1), KOPI AI AGENT
许可证MIT
平台linux, macos
标签Payments, Stripe, Projects, Provisioning, Infrastructure
相关 skillstripe-link-cli, mpp-agent

参考:完整 SKILL.md​

信息

以下是 Kopi Agent 在触发此 skill 时加载的完整 skill 定义。这是 skill 处于激活状态时 agent 所看到的指令。

Stripe Projects Skill

封装 Stripe Projects CLI 插件,使 Kopi Agent 能够配置 SaaS 服务(Neon、Twilio、Vercel 等)、生成凭证并同步到用户的 .env,以及在一处统一管理各 provider(服务提供商)的账单。

在 Windows 上,随着整个 payments 集群逐步成熟,目前通过 [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?"

如果用户已经拥有 provider 账户,此 skill 仍可将其与 stripe projects link <provider> 连接。如果用户希望使用现有的 provider 资源(例如现有的数据库或 Vercel 项目),请先检查 provider 的支持情况;目前许多 provider 仅支持配置新资源,而不支持导入现有资源。

前提条件​

  • 已安装 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(加密的凭证存储)并准备项目以接收 provider。

2. 发现可用的 provider​

stripe projects catalog

列出 Stripe Projects 支持的所有 provider — 包括数据库、托管、认证、AI、分析、消息等类别。

3. 添加服务​

stripe projects add <provider>/<service>

示例:

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

CLI 会在用户自己的 provider 账户中配置该服务,生成凭证,将其同步到 .env,并在 vault 中记录该资源。用户可能需要确认套餐选择或定价提示。

4. 验证​

stripe projects list

应显示新添加的 provider 及其 .env 密钥。

5. 管理 / 升级 / 移除​

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

注意事项​

  • .env 写入是真实的写入操作。 CLI 会追加到项目根目录中已有的 .env。如果用户的 .env 已被 gitignore(这是常规做法),密钥就是安全的;如果没有,此 skill 可能成为凭证泄露的途径。请务必先检查 .gitignore。
  • 按项目隔离状态。 .projects/vault/vault.json 是按项目独立的。在两个不同项目中配置同一服务会创建两个独立资源 — 也就意味着两份账单。
  • 账单在 Stripe 侧产生。 add/upgrade 过程中的套餐提示会产生真实费用;请在确认之前向用户明确说明。
  • provider 的可用性会变化。 目录会不断扩充;如果用户提到的某个 provider 未在列表中,请先执行 stripe projects catalog | grep <name>,而不是直接让 add 调用失败。
  • vault 中的凭证是加密的,但 .env 是明文的。 需遵循标准的 .env 安全规范 — 切勿将其提交到版本库。
  • 移除服务并不总是会销毁底层资源。 某些 provider 会留下一个已暂停/休眠的资源。对于高成本服务(尤其是托管数据库),请在 remove 后检查 provider 自己的控制台。

验证​

stripe projects --version && stripe projects list

在已初始化的项目中退出代码为 0 表示插件运行正常。