SuperAPI AI 工具集

first-flag

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:在 SDK 已连接后,引导用户创建第一个布尔型功能开关(flag),并在应用中完成求值与开关验证,形成端到端证明。属于 LaunchDarkly 入门流程第 6 步,前置步骤为应用代码改动。

主要能力:创建布尔 flag(默认 true/false 两个变体,temporary 为 true);按 SDK 规则生成求值代码;验证默认关闭时返回 false;开启后验证返回 true;可选添加交互式演示(前端横幅、后端 /launchdarkly-demo 端点等)。

使用方式:创建 flag 可用 MCP 的 create-feature-flag、LaunchDarkly API(POST /api/v2/flags/PROJECT_KEY)或 ldcli flags create。开启可用 MCP 的 update-feature-flag(JSON Patch)、API 的 PATCH 语义补丁(turnFlagOn)或 ldcli flags toggle-on。凭据须用环境变量 $LAUNCHDARKLY_ACCESS_TOKEN,禁止把令牌字面值写入命令。

关键注意:部分 SDK 会转换 flag key,如 React 的 useFlags() 默认把 kebab-case 转 camelCase(my-first-flag → myFirstFlag),可通过 reactOptions: { useCamelCaseFlagKeys: false } 关闭;多数服务端 SDK 保持原 key。创建、配置与代码引用三处必须一致。

适用场景:首次接入 LaunchDarkly、需要快速验证 SDK 与 flag 是否打通的开发者。

限制:仅覆盖首个布尔 flag;401/403 授权错误需用户手动处理,不可自动重试;更复杂的定向、百分比发布等需其他技能或文档。可选安装 launchdarkly-flag-create 技能(npx skills add launchdarkly/ai-tooling --skill launchdarkly-flag-create -y --agent <agent>)。