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 |
| 相关 skill | stripe-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/postgresstripe projects add twilio/smsstripe 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 表示插件运行正常。