Stripe Projects 用于通过 Stripe CLI 的 Projects 插件开通第三方服务,包括数据库、身份认证、托管、分析、缓存、AI、可观测性等类别,并获取相应 API 密钥或令牌。
主要能力与典型用途:
- 搜索服务目录并确认所需服务商或服务是否存在。
- 初始化 Stripe 项目,并为后续服务添加准备本地技能。
- 在本地技能引导下添加服务商、管理凭据与配置项目。
- 查看已开通服务、列出环境变量名称、检查项目健康状态、浏览可用服务。
- 管理项目变量,用于存储非服务商提供的环境变量,例如应用 URL、功能开关或自管 API 密钥。
使用方式(按资料中的工作流):
- 确保 Stripe CLI 与 Projects 插件可用:使用 which stripe && stripe --version 检查;如缺失或需升级,macOS 可用 brew install stripe/stripe-cli/stripe 或 brew upgrade stripe/stripe-cli/stripe,其他平台按 https://docs.stripe.com/stripe-cli/install 操作;随后执行 stripe plugin install projects。
- 搜索目录:stripe projects search <query> --json;若结果数为 0,则告知用户未找到并停止;若需求模糊(如“我需要数据库”),可浏览目录建议选项:stripe projects catalog --json。
- 初始化项目:先检查 stripe projects status --json;若报告工作区尚无已初始化项目,则运行 stripe projects init --accept-tos --yes --json。若初始化返回浏览器配对交接(BROWSER_AUTH_REQUIRED,details.reason 为 handoff_prepared),向用户展示 details.browser_url 与 details.verification_code,等待用户在浏览器批准并确认后,用原参数重试同一 init 命令;代码过期前重跑会重新呈现同一代码,不要另开 stripe login。
- 交接给 stripe-projects-cli:用 Read 打开 .agents/skills/stripe-projects-cli/SKILL.md,必要时回退到 .claude/skills/stripe-projects-cli/SKILL.md;若两个文件都不存在,可重试一次 stripe projects init --accept-tos --yes --json 修复安装,再检查两处路径;若初始化失败或技能仍缺失,按 CLI 消息与后续步骤向用户报告问题并停止,不要持续重试。之后使用本地安装的技能添加服务商、管理凭据或配置项目,可用时通过 Skill 工具调用 stripe-projects-cli,否则直接遵循已读取的 SKILL.md。
- 成功添加服务后,按以下字段汇总:Provider、Service、Tier、Env vars(仅变量名称,绝不包含值);然后从目录不同类别中建议 3 至 5 个互补服务,只能引用 stripe projects catalog --json 实际出现的服务,不得编造命令或服务商名称。
状态与变量管理:
- CLI 为状态权威来源,所有状态由 CLI 管理在 .projects/ 下并生成 .env 文件,不要手工编辑;仅在用户明确要求时才直接查看 .projects/ 或 .env。
- 常用命令:查看已开通服务用 stripe projects status --json;列出环境变量名称用 stripe projects env --json;检查项目健康用 stripe projects status --json;浏览可用服务用 stripe projects catalog --json。
- 项目变量:创建或更新当前环境变量用 stripe projects variables set <name> --env-key <ENV_KEY> --value <value>,成功后会立即同步当前环境输出文件;若用户未提供值,仅可在交互模式下不带 --value 运行,由 CLI 安全提示;绝不在回复中打印秘密值。绑定已有项目变量用 stripe projects env add <name> --variable --env-key <ENV_KEY>;解除绑定但不删除存储变量用 stripe projects env remove <name> --variable;列出与删除用 stripe projects variables list --json 和 stripe projects variables delete <name> --yes。
- 以每条 CLI 响应作为消息、后续步骤与重试条件的依据;展示浏览器交接与其他用户操作时,不暴露账户标识、凭据或秘密值;在 CLI 要求用户操作处等待,随后只重试 CLI 指明可重试的命令与参数。账户选择与服务商选择交由用户决定,不单凭错误代码推断资格、批准或恢复命令。
限制与注意事项:
- 不使用 CLI 以外的状态来源;手工修改可能被覆盖。
- 不编造服务商名称或命令,建议只基于实际目录输出。
- 浏览器批准本身并不代表 Projects 已就绪。
- 若服务搜索无结果,应告知用户并停止。
- 关于具体收费、价格、各服务商支持范围与效果,资料中暂未提供。