需要为代码库设置 LaunchDarkly…

在代码库中初始化或管理 LaunchDarkly 项目，并按架构选择 Quick Setup、多项目、项目克隆、IaC 或管理工具路径。

适用场景

解决思路

1. 先探索代码库理解技术栈和模式，遵循“先理解”原则。
2. 识别技术栈：语言（Python、Node.js、Go、Java 等）、框架（FastAPI、Express、Spring Boot 等），以及是否已有 LaunchDarkly 集成。
3. 检查环境管理：环境变量如何存储（.env 文件、secrets manager、配置文件），配置在哪里加载（启动脚本、配置模块），是否已有 LaunchDarkly SDK key。
4. 查找现有模式：是否已有 API client 或 service module、外部 API 集成通常怎么做、是否存在 CLI、scripts 目录或 admin tooling。
5. 理解用例：是新项目设置、添加到现有 LaunchDarkly 集成、多服务架构的一部分，还是需要跨区域/团队克隆项目。
6. 根据探索结果评估并选择路径：新项目且无 LaunchDarkly 集成走 Quick Setup，创建项目并保存 SDK key。
7. 已有 LaunchDarkly 使用：走 Add to Existing，创建新项目或使用已有项目。
8. 多个服务/微服务：走 Multi-Project，为每个服务创建项目。
9. 多区域或多租户：走 Project Cloning，克隆模板项目。
10. 基础设施即代码（IaC）设置：走 Automated Setup，基于脚本创建。
11. 需要项目管理工具：走 CLI/Admin Tools，构建项目管理实用工具。
12. 按语言/技术栈选择实现参考：Python 用 references/python-setup.md，Node.js/TypeScript 用 references/nodejs-setup.md，Go 用 references/go-setup.md，多语言用 references/multi-language-setup.md。
13. 按用例选择参考：Quick Start 用 references/quick-start.md，环境配置用 references/env-config.md，项目克隆用 references/project-cloning.md，IaC/自动化用 references/iac-automation.md，管理工具用 references/admin-tooling.md。
14. 遵循现有代码风格和结构，选择与架构匹配的方法。
15. 在提示用户输入 API key 前自动检测：检查环境变量 LAUNCHDARKLY_API_KEY、LAUNCHDARKLY_API_TOKEN、LD_API_KEY。
16. 如果使用 Claude，读取 ~/.claude/config.json 中的 mcpServers.launchdarkly.env.LAUNCHDARKLY_API_KEY。
17. 只有在自动检测失败时，才提示用户提供 API key。
18. 查看 references/quick-start.md 了解 API 使用模式。
19. 实现集成时，API 认证：安全存储 API token，遵循现有 secrets 管理方式，绝不将 token 提交到版本控制。
20. 项目命名：使用一致、描述性的名称，遵循现有命名约定；项目 key 用小写字母、连字符，并以字母开头。
21. SDK key 管理：为每个环境提取并存储 SDK key，使用代码库中其他 secret 的同一模式，考虑为 test/staging/production 使用不同 key。
22. 错误处理：优雅处理已存在项目（409 conflict），提供清晰错误信息，不要静默失败。
23. 验证项目存在：优先使用 MCP 的 get-project 工具，而不是原始 curl；它返回可直接检查的类型化对象。
24. 如果必须调用 REST API，使用：curl -X GET "https://app.launchdarkly.com/api/v2/projects/{projectKey}?expand=environments" -H "Authorization: {api_token}"。
25. 不要将响应直接管道给 `.environments.items[]` 风格的 jq 过滤器；environments 的形状会随 expand 参数变化，有时是 {items: [...]}，有时是裸数组，手工过滤器会报 Cannot index array with string "items"。
26. 先运行 `jq -e .` 检查实际形状，或使用 `jq '.environments | if type == "object" then .items else . end'` 同时处理两种形状。
27. 测试 SDK 集成：运行快速验证确保 SDK key 可用：import ldclient from ldclient.config import Config ldclient.set_config(Config("{sdk_key}")) # SDK initializes successfully # Always flush events before closing — trailing events are at risk of being lost otherwise, in short-lived scripts and long-running services alike. ldclient.get().flush() ldclient.get().close()。
28. 报告结果：✓ 项目存在且有环境；✓ SDK key 存在且有效；✓ SDK 能初始化（或标记问题）。
29. 项目 key 必须遵循规则：好例子 “support-ai”、“chat-bot-v2”、“internal-tools”；坏例子 “Support_AI”（不能有大写或下划线）、“123-project”（必须以字母开头）、“my.project”（不能有点）。
30. 命名建议：key 保持简短但描述性；使用 team/service/purpose 作为命名方案；在整个组织中保持一致。
31. 常见组织模式：按团队命名如 platform-ai、customer-ai、internal-ai；按应用/服务命名如 mobile-ai、web-ai、api-ai；按区域/部署命名如 ai-us、ai-eu、ai-apac。
32. 处理边界情况：项目已存在时，检查是否是正确项目；使用它或用不同 key 创建。
33. 需要多个项目时，为每个服务/区域/团队分别创建。
34. 服务间共享配置时，使用同一项目并通过 SDK context 区分。
35. token 缺少权限时，请求 projects:write 或使用 MCP server。
36. 项目名称冲突时，key 必须唯一，名称可以相似。
37. 不要在不理解用例前创建项目。
38. 不要将 API token 或 SDK key 提交到版本控制。
39. 不要在测试/开发环境使用生产 SDK key。
40. 不要不必要地创建重复项目。
41. 不要跳过探索阶段。
42. 设置项目后，创建 configs（使用 configs-create skill）。
43. 设置项目后，设置 SDK 集成（使用 sdk skill）。
44. 设置项目后，配置 targeting（使用 configs-targeting skill）。

适用边界 · 注意事项

• 没有 LaunchDarkly API access token（需 projects:write 权限）或未配置 LaunchDarkly MCP server 时，不适用。
• 只需要配置已有项目的 targeting、variations 或 SDK 集成，而不是创建/管理项目时，不适用。
• 不使用 LaunchDarkly 或使用其他功能开关平台时，不适用。