sdk-install

LaunchDarkly SDK 安装（入门）

按顺序执行三个嵌套技能，为用户的项目安装并初始化合适的 LaunchDarkly SDK。此处不要直接跳到功能标志——父级 LaunchDarkly 入门 将继续执行步骤 4：首个标志。

前置条件

• 父级步骤 1：探索项目中获取的项目上下文（请复用；只有在有不清楚的地方时，才重新进行深入检测）
• **SDK key / client-side ID / mobile key：**在执行应用代码更改时才需要（配置环境变量）。不要仅仅因为打开了此技能，就在检测或规划期间向用户索要这些信息——请遵循父级入门流程：如果已配置 MCP，则通过 MCP OAuth 推断账户状态；否则在应用阶段的 D7 中展示；在应用阶段收集密钥材料（参见父级前置条件）。

密钥类型（摘要）

SDK 类型	变量（逻辑名称）	LaunchDarkly 中的位置
服务端	LAUNCHDARKLY_SDK_KEY	Environments → SDK key
客户端	Client-side ID（带打包工具前缀的环境变量名称）	Environments → Client-side ID
移动端	LAUNCHDARKLY_MOBILE_KEY	Environments → Mobile key

**绝不要对密钥进行硬编码。**完整的环境变量规则、授权和打包工具表格：见应用代码更改步骤 2。

工作流——按顺序运行以下嵌套技能

除非检测决策树提前终止流程（例如，直接跳到应用阶段），否则请执行全部三个技能。每个嵌套技能都可能包含决策点——有些会阻塞（标记为 D<N> -- BLOCKING，此时必须调用结构化提问工具，并等待用户回复后才能继续），有些则不阻塞（展示信息后继续，除非用户提出异议）。不要跨越阻塞边界批量调用工具。

顺序	嵌套技能	作用
1	检测代码库技术栈	语言、包管理器、单体仓库目标、入口点、现有的 LD 用法
2	生成集成计划	SDK 选择、要更改的文件、环境变量计划——向用户展示（不阻塞；参见 plan SKILL.md D6）
3	应用代码更改	安装软件包、在获得授权后配置 .env / 密钥、初始化代码、编译检查（执行双 SDK 计划时，两条路径都要处理）

所有步骤共用的参考资料：SDK 配方、SDK 代码片段。

步骤 3 完成后

继续执行父级技能：

• 步骤 4：首个标志

除非用户明确需要临时检查，否则不要在此技能中独立添加“示例标志”评估；父级流程会按顺序创建首个标志。

指南

• 遵循现有代码库的导入、配置和代码风格惯例。
• 在 TypeScript 项目中优先使用 TypeScript。
• 如果项目使用共享配置层，请在该层初始化 LaunchDarkly。
• 如果项目使用 dotenv，请添加 .env.example 条目。
• 依赖范围：除非用户明确同意升级或添加其他软件包，否则只添加配方中指定的 LaunchDarkly SDK 软件包（参见应用阶段——更改其他依赖项前先征得许可）。

边缘情况

• 多个环境（例如 Next.js 服务端 + 客户端），或用户要求同时支持前端 + 后端： 使用双 SDK 计划，并对两个软件包都执行应用，且分别完成两次初始化——没有锁文件 + 入口点证据时，绝不要将第二个 SDK 概括为已完成。
• 单体仓库： 在父级引导流程中集成用户选择的软件包；仅在该子树内操作。
• SDK 已安装并初始化： 父级流程可以跳过此交接——参见父级的边缘情况和检测决策树。
• 不受支持或不常见的技术栈： 使用SDK 配方和完整 SDK 目录。

参考资料

• 检测仓库技术栈
• 生成集成计划
• 应用代码更改
• SDK 配方
• SDK 代码片段
• LaunchDarkly 引导流程（父级）