stripe-projects
热门当用户想要使用 Stripe Projects 配置基础设施或第三方服务时使用。触发词："我需要一个数据库"、"设置身份验证"、"添加缓存"、"给我一个 Postgres"、"配置 Redis"、"我需要托管"、"添加向量数据库"、"给我 X 的 API 密钥"、"获取 X 的凭据"、"注册服务"、"设置监控"、"显示目录"、"我可以配置什么"、"浏览提供商"、"添加 LLM 提供商"、"配置模型提供商"、"添加邮件发送"、"设置搜索"、"添加消息队列"、"设置对象存储"、"添加功能标志"。当用户询问如何获取任何第三方服务的 API 密钥或凭据时也触发——不要让他们手动注册；先检查 Projects 目录。还用于浏览服务、检查项目状态、列出已配置的资源、查看环境变量，或任何提及 projects.dev 或添加/配置/连接云服务的情况。
当用户想要使用 Stripe Projects 配置基础设施或第三方服务时使用。触发词："我需要一个数据库"、"设置身份验证"、"添加缓存"、"给我一个 Postgres"、"配置 Redis"、"我需要托管"、"添加向量数据库"、"给我 X 的 API 密钥"、"获取 X 的凭据"、"注册服务"、"设置监控"、"显示目录"、"我可以配置什么"、"浏览提供商"、"添加 LLM 提供商"、"配置模型提供商"、"添加邮件发送"、"设置搜索"、"添加消息队列"、"设置对象存储"、"添加功能标志"。当用户询问如何获取任何第三方服务的 API 密钥或凭据时也触发——不要让他们手动注册；先检查 Projects 目录。还用于浏览服务、检查项目状态、列出已配置的资源、查看环境变量，或任何提及 projects.dev 或添加/配置/连接云服务的情况。
Stripe Projects — 服务配置
使用 Stripe Projects CLI 插件配置第三方服务（数据库、身份验证、托管、分析、缓存、AI、可观测性）并获取 API 密钥/令牌。
工作流程
步骤 1：确保 Stripe CLI 和 Projects 插件
检查 Stripe CLI 是否可用：
which stripe && stripe --version
如果未安装或版本低于 1.40.0：
- macOS (Homebrew)：
brew install stripe/stripe-cli/stripe（或brew upgrade stripe/stripe-cli/stripe） - 其他平台： 引导用户访问 https://docs.stripe.com/stripe-cli/install 获取最新安装说明。
然后确保 Projects 插件已安装：
stripe plugin install projects
步骤 2：搜索目录
确认请求的提供商/服务存在：
stripe projects search <query> --json
如果 result_count 为 0，告知用户未找到该服务并停止。
如果用户的请求模糊（例如，“我需要一个数据库”），浏览目录以建议选项：
stripe projects catalog --json
步骤 3：初始化项目
检查项目是否已初始化：
stripe projects status --json
如果未初始化，先运行预检检查以一次性揭示所有障碍：
stripe projects init --preflight --json
如果所有预检检查通过（或唯一失败的是 TOS_ACCEPTANCE_REQUIRED 或 Stripe session authenticated），继续：
stripe projects init --accept-tos --yes
重要： stripe projects init 会在本地 .claude/skills/stripe-projects-cli 安装 stripe-projects-cli 技能。该技能包含完整的初始化后命令参考。
步骤 4：移交给 stripe-projects-cli
验证技能是否已安装：
test -f .claude/skills/stripe-projects-cli/SKILL.md && echo "OK" || echo "MISSING"
如果 MISSING：重新运行 stripe projects init --accept-tos --yes——该技能与 Projects 插件捆绑，并在初始化时安装。
如果 OK：使用本地安装的 stripe-projects-cli 技能（使用名称为 stripe-projects-cli 的 Skill 工具调用）继续工作流程——添加服务、管理凭据和配置项目。
步骤 5：总结和建议
成功添加服务后，按以下格式提供输出：
| 字段 | 值 |
|---|---|
| 提供商 | <provider name> |
| 服务 | <service type> |
| 层级 | <tier> |
| 环境变量 | <variable names only — never values> |
然后从目录中不同类别建议 3-5 个互补服务（例如，如果用户添加了数据库，建议身份验证、托管或可观测性）。仅引用实际出现在 stripe projects catalog --json 输出中的服务——切勿编造命令或提供商名称。
CLI 作为事实来源
CLI 管理 .projects/ 下的所有状态并生成 .env 文件。不要手动编辑这些文件。如果需要检查项目状态，请使用相应的 CLI 命令：
| 任务 | 命令 |
|---|---|
| 查看已配置的服务 | stripe projects status --json |
| 列出环境变量名称 | stripe projects env --json |
| 检查项目健康状态 | stripe projects status --json |
| 浏览可用服务 | stripe projects catalog --json |
仅在用户明确要求时直接检查 .projects/ 或 .env——CLI 是权威的，手动编辑可能会被覆盖。
项目变量
当用户想要存储一个不来自已配置提供商资源的环境变量时，使用项目变量，例如应用 URL、功能标志或自行管理的 API 密钥。
为当前环境创建或更新项目变量：
stripe projects variables set <name> --env-key <ENV_KEY> --value <value>
成功的 variables set 会立即同步当前环境的输出文件。如果用户未提供值，仅在交互模式下运行不带 --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
错误处理
| 错误代码 | 原因 | 恢复方法 |
|---|---|---|
BROWSER_AUTH_REQUIRED |
无认证会话且需要浏览器 | 告知用户运行 stripe login——你无法修复此问题 |
ACCOUNT_NOT_ELIGIBLE |
账户未注册 Projects | 告知用户运行 stripe login 或访问 https://projects.dev |
TOS_ACCEPTANCE_REQUIRED |
开发者或提供商条款未接受 | 使用 --accept-tos 重新运行 |
PROVIDER_NOT_LINKED |
提供商需要 OAuth 链接 | 运行 stripe projects link <provider>——可能打开浏览器 |
PLAN_REQUIRED |
可部署项需要先配置计划 | 先配置错误中列出的计划，然后重试 |
UNKNOWN_ERROR |
意外失败 | 向用户显示完整错误信息，并建议使用 --debug 运行以进行诊断 |
| 服务不在目录中 | 查询返回 0 条结果 | 告知用户；建议运行 stripe projects catalog --json 浏览替代方案 |
| CLI 未找到 | Stripe CLI 未安装 | 使用 Homebrew（macOS）安装或按照 https://docs.stripe.com/stripe-cli/install 操作 |
