SuperAPI AI 工具集

apply

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:这是 LaunchDarkly SDK 安装(onboarding)流程中的嵌套步骤「apply」,承接「生成集成方案」,后续为「启动应用」。目标是把已批准的方案落地为代码改动,而不是重新规划。

主要能力:

  1. 安装 SDK 依赖:严格使用已匹配的 SDK recipe 中给出的确切包名与安装命令,并配合项目现有包管理器;安装后确认依赖出现在 lock 文件或依赖清单中。若方案为双 SDK,两套包都要真实安装,不得只装一套就声称完成。
  2. 配置密钥与隐私:不得把 SDK key / client-side ID / mobile key 硬编码在源码中,只能通过环境变量引用;服务端用 LAUNCHDARKLY_SDK_KEY,移动端用 LAUNCHDARKLY_MOBILE_KEY,浏览器端使用 client-side ID 并按打包器前缀命名(CRA 用 REACT_APP_…,Vite 用 VITE_…,Next.js 用 NEXT_PUBLIC_…,其他栈匹配项目现有公开变量前缀)。
  3. 添加初始化代码:以 SDK recipe、snippets 中的 SDK 详情文件及 LaunchDarkly 官方文档为准,从应用入口点导入并尽早初始化,等待初始化完成后再评估 flag,处理错误但不让应用崩溃,并保持与现有代码风格一致。
  4. 编译验证:运行项目构建/编译步骤,如配置了 linter 也一并运行,修复导入或类型问题。

必要用法:安装依赖前须获得常规仓库修改同意;超出范围(升级、降级、固定或新增非 LaunchDarkly 包、npm audit fix、批量更新、改动 engines/packageManager/resolutions/workspaces 等)必须先用结构化提问工具取得明确批准,遇 peer 冲突或安装失败时阻塞询问,不得静默升级旧仓库。写入任何真实密钥前同样必须用结构化提问工具让用户显式选择处理方式(告知位置 / 用户自设 / 写入 .env / 尚无账号);未经选择不得获取或写入真实密钥。若通过 MCP 获取密钥,使用 get-environments 工具并按其返回选择正确密钥类型;MCP 未配置则引导用户到 LaunchDarkly 控制台获取。写入 .env 前须确认 .env 已列入 .gitignore;.env.example 只放占位符;.env 中只追加或更新 LaunchDarkly 相关行,不动无关变量。

适用场景:已有的 LaunchDarkly 集成方案需要落地执行的仓库,包括服务端、浏览器、移动端及服务端+客户端双 SDK 场景。

限制:本技能不提供各 SDK 的复制粘贴示例,凭记忆套用错误片段会误导;密钥设置需要用户账号,无账号时只能先写占位变量,应用在真实密钥就位前连不上 LaunchDarkly,属预期现象。双 SDK 时两套安装、凭据行与入口初始化都必须各自真实完成。