flag-release — скилл для Claude Code: автоматический релиз feature-флага
Скилл flag-release для Claude Code, Codex, Cursor и других агентов фиксирует автоматический роллаут существующего LaunchDarkly-флага, чтобы изменение вышло после мержа PR без ручного переключения.
Apache-2.0 275 установок ★ 32 обновлён 2026-11-11
npx skills add launchdarkly/ai-tooling --skill flag-release -a claude-codeЧто делает flag-release
Скилл берёт флаг, который уже существует в LaunchDarkly в состоянии OFF, и через MCP-инструмент create-automated-rollout-config привязывает к нему роллаут конкретного PR. На момент мержа флаг начинает работу по выбранной стратегии — немедленный релиз или policy, которая запускает собственный сценарий среды (immediate, progressive или guarded) без участия человека.
Перед записью скилл прогоняет match-release-policies для каждой среды, чтобы определить, что именно будет делать policy при мерже, и get-flags, чтобы убедиться, что флаг существует и выключен. Среды, которые нужно придержать, просто не включаются в массив environments — это единственный способ оставить флаг OFF там: запись с releaseType: "policy" не откладывает релиз, а проводит его автоматически при мерже.
Скилл принимает явное намерение: немедленный релиз, удержание, notBefore-дату, сегмент или флаг-предусловие. Без MCP-сервера LaunchDarkly скилл не запустится — он использует только удалённые инструменты этого сервера и не редактирует код.
Какие задачи решает
- зафиксировать автоматический роллаут LaunchDarkly-флага после мержа PR
- удержать среду от релиза, исключив её из роллаута
- проверить политику релиза каждой среды перед записью
- привязать staged-роллаут к конкретному pull request
- передать намерение «не раньше даты» без ручного переключения флага
Примеры запросов агенту
- Зафикcируй роллаут флага
payment-v2для PR #341 вmy-org/my-repo— релиз вproduction, средуstagingпридержи - Запусти flag-release для флага
dark-launch-search: немедленный релиз вproduction,canaryпо политике проекта - Используй flag-release: флаг
checkout-refactorуже создан, PR #118, средуeu-prodне включай — ждём sign-off
Как установить flag-release
1Через Skills CLI (Vercel)
npx skills add launchdarkly/ai-tooling --skill flag-release -a claude-code2Вручную: положить файлы
~/.claude/skills/flag-release/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/flag-release/
1Через Skills CLI (Vercel)
npx skills add launchdarkly/ai-tooling --skill flag-release -a codex2Вручную: положить файлы
.agents/skills/flag-release/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add launchdarkly/ai-tooling --skill flag-release -a cursor2Вручную: положить файлы
.cursor/skills/flag-release/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install launchdarkly/ai-tooling skills/feature-flags/flag-release2Вручную: положить файлы
.github/skills/flag-release/SKILL.md1Через Skills CLI (Vercel)
npx skills add launchdarkly/ai-tooling --skill flag-release -a gemini-cli2Командой платформы
gemini skills install https://github.com/launchdarkly/ai-tooling --path skills/feature-flags/flag-releaseВручную: положить файлы
.devin/skills/flag-release/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add launchdarkly/ai-tooling --skill flag-release -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о flag-release
Как установить flag-release в Claude Code?
Выполните npx skills add launchdarkly/ai-tooling --skill flag-release -a claude-code. Скилл появится по пути ~/.claude/skills/flag-release/SKILL.md.
Что делает скилл flag-release?
Он фиксирует автоматический роллаут существующего LaunchDarkly-флага, привязанного к PR, — без ручного переключения. Код и флаг уже должны существовать; скилл только записывает конфигурацию релиза.
Можно ли отложить релиз для конкретной среды через flag-release?
Да, но способ один: просто не включать среду в массив environments. Запись с releaseType: "policy" не удерживает релиз — она запускает его автоматически при мерже по политике среды.
Исходный текст
SKILL.md · Apache-2.0
---
name: flag-release
description: "Record an automated rollout for an existing LaunchDarkly flag that guards a pull request's change, so the change releases safely when the PR merges. Honors a stated release intent (release now / hold / notBefore / segment / prerequisite) and defers per-environment to the project's release policies. Use as the release step once the guarding flag exists and its code is wired. Keywords: record release, automated rollout, release policy, guarded rollout, staged rollout, immediate vs policy, release intent, hold release, dark launch."
license: Apache-2.0
compatibility: Requires the remotely hosted LaunchDarkly MCP server. Operates on a flag that already exists; does not create flags or edit code.
metadata:
author: launchdarkly
version: "0.1.0"
---
# Record a Flag's Automated Release
You're using a skill that takes an **existing** feature flag (created OFF) that guards a pull request's change, and records an **automated rollout** so the change releases safely once the PR merges — no human toggling a flag. It defers per-environment to the team's release policies and honors any human-stated release intent.
This is the **release step** of the PR flag workflow, and it's deliberately atomic:
| Step | Owned by |
|------|----------|
| Decide *whether* to flag | [`should-flag-change`](../should-flag-change/SKILL.md) (advisory) |
| Create the flag + wire the code | [`launchdarkly-flag-create`](../launchdarkly-flag-create/SKILL.md) |
| **Record the release** | **this skill** |
By the time this skill runs, the flag exists (OFF) and the guarding code is wired and pushed. This skill only records the rollout — it never creates flags or edits code. It can be driven directly by an automation harness, or as the final step of the [`flag-and-release-change`](../flag-and-release-change/SKILL.md) orchestrator.
**The deploy is not the release.** The merge ships the control path (flag OFF); the *release* is the flag operation this rollout performs afterward, governed by the environment's policy.
> **Honoring a hold is the one thing you must get right.** There is no "hold" release type, and **`policy` is NOT a manual gate.** On merge, `policy` *automatically* performs the environment's release (immediate, progressive, or guarded) with **no human promotion step** — a guarded rollout still *starts on its own* the moment the PR merges. So recording a held environment as `policy` does **not** hold it; it releases it on merge, before any `notBefore` date. The only way to hold an environment is to **omit it from the `environments` array entirely**, which leaves the flag OFF there. If the user wants an environment held (or not released until a date), exclude it from the call and report it as held. When in doubt, omit.
## Prerequisites
- The remotely hosted LaunchDarkly MCP server.
- The guarding flag already exists in LaunchDarkly, created OFF, with the agreed key/tags.
- A pull-request reference (`repoFullName` + `prNumber`, or `prUrl`) so the rollout binds to the right merge.
**MCP tools this skill uses:**
- `create-automated-rollout-config` — record the rollout for the flag against the PR *(the deliverable)*. It has no field for holding, scheduling, or a `notBefore` date: every environment in its `environments` array releases on merge, and a held environment is left out.
- `match-release-policies` — resolve which release policy governs each environment (call before proposing the plan)
- `get-release-policies` — see the project's release policies and the metrics they auto-attach
- `get-flags` — confirm the flag exists and is OFF before recording
Full release model — immediate vs `policy`, precedence, previewing, prerequisites, metric adequacy: [references/auto-release.md](references/auto-release.md).
## Plan Phase
**Record nothing in this phase.**
1. **Confirm the flag.** `get-flags` to verify the guarding flag exists and is OFF. If it doesn't exist yet, stop — creation is [`launchdarkly-flag-create`](../launchdarkly-flag-create/SKILL.md)'s job, and recording a rollout for a missing flag fails confusingly.
2. **Pick the target environments.** Use the environments named by the user or harness. Don't hardcode a set — a given change can't always release to every environment. If none are named, enumerate the project's real keys and confirm the set rather than assuming.
3. **Preview each environment's policy.** Call `match-release-policies` (with `projectKey`, `flagKey`, and `environmentKey`) to resolve, deterministically, what a `policy` release will do per environment — `winningPolicy.releaseMethod` (`immediate-release` / `progressive-release` / `guarded-release`), or no policy when `winningPolicy` is null. Don't reason about policy scope by hand. For a **guarded** winner, check the auto-attached metrics can actually compare this change (see the metric-adequacy note in [references/auto-release.md](references/auto-release.md)).
4. **Capture the human's release intent.** Ask (briefly, only if not already stated): release **on merge**, **hold** (recorded but not released yet), or wait until a **`notBefore`** date? A **cohort/segment** to target first? A **prerequisite** parent flag this must not precede? Intent sits above the policy in precedence and is **honored or explicitly held — never silently dropped**.
5. **Present the per-environment plan and stop.** For each environment, state either how it will be recorded (immediate, or `releaseType: "policy"`, and what that does on merge) **or** that it will be **held** — omitted from the recorded config so the flag stays OFF there — with the reason. Wait for confirmation; revise on feedback.
## Implement Phase
Only after confirmation:
1. **Sort every target environment into exactly one bucket — RELEASE or HOLD.** Do this *before* you build the call. There is no third bucket, and no entry shape creates one.
| Bucket | Meaning | What goes in the call |
|--------|---------|-----------------------|
| **RELEASE** | Goes live on merge — now, or per its policy | Add `{ environmentKey }` (immediate) or `{ environmentKey, releaseType: "policy" }` to the `environments` array |
| **HOLD** | Not yet — waiting on a date, sign-off, segment, or parent flag | **Nothing.** Leave it out of `environments` entirely; name it as held in your report |
The entry shape (immediate vs `policy`) only chooses *how* a RELEASE environment goes live — it never holds one. **Both release on merge:** an immediate entry (`environmentKey` alone, no `releaseType`) serves `true` immediately; `policy` runs that environment's policy (immediate / progressive / guarded) automatically, with no human promotion step. "`policy` defers to the *policy*" — not to you, and not until a date. **Do not reach for `policy` to park a held environment: it ships that environment on merge, before any `notBefore`.** The only encoding of a hold is *absence from the array*.
2. **Build `environments` from the RELEASE bucket only — then read the keys back.** The array must contain every RELEASE environment and no HOLD environment. Before you send the call, scan the `environmentKey`s in the array: if any environment you're holding appears there, delete that entry. The call has **no field for a date or a hold** — if you catch yourself wanting to add `holdUntil`, `notBefore`, or `hold` to an entry (or to keep it as `policy` "so it waits"), that is the signal the environment is HOLD: **drop the entry, don't invent a field.** The date and reason go in your report, not the call.
Worked example — *"release staging on merge, hold production until 2026-09-01"*: staging is RELEASE, production is HOLD.
```json
{
"projectKey": "default",
"flagKey": "new-checkout-flow",
"environments": [{ "environmentKey": "staging" }],
"repoFullName": "acme/storefront",
"prNumber": 482
}
```
`production` appears nowhere in the call. You report it held until 2026-09-01, with the reason (legal sign-off). Fail closed: if an environment's intent is unclear, it's HOLD, not RELEASE.
3. **Record the rollout.** Call `create-automated-rollout-config` with `projectKey`, `flagKey`, the RELEASE-only `environments` array, and the PR reference. If a **prerequisite** parent flag was agreed, wire it if the MCP surface supports it; otherwise report it as a manual step. Details: [references/auto-release.md](references/auto-release.md).
4. **Verify.** The call returns `created`, `config_id`, and the normalized per-environment plan — record `config_id`. Report only what you verified; flag anything you couldn't confirm rather than asserting it.
5. **Report** the per-environment release plan + `config_id`; what was **held** (and why) versus what releases on merge; and what happens on merge (e.g. "production resolves policy X → guarded rollout on merge; staging serves true immediately; production held until 2026-08-01 per intent").
## Edge Cases
| Situation | Action |
|-----------|--------|
| Flag doesn't exist yet | Stop — creation is `launchdarkly-flag-create`. Recording a rollout for a missing flag fails confusingly. |
| A rollout config already exists for this flag + PR | Don't record a second one — a duplicate confuses the scheduler. Point the user at the existing config to change the plan. |
| Registering before the PR exists | Immediate envs work without a PR, but `policy` envs need `repoFullName`/`prNumber` to trigger on merge. Prefer recording *after* the PR is open; if you record early, say `policy` won't fire until the PR is wired. |
| No release policy matches an env | `policy` falls back to defaults (often immediate). Tell the user; offer an immediate release, or point at release-policy setup. |
| User wants to hold, or set a `notBefore` date | Skip the releasing plan for those environments; report them as held with the reason. Never silently release against stated intent. |
| Change depends on a parent flag not yet live | Couple them with a prerequisite (set it if the MCP surface supports it); otherwise report the coupling as a required manual step. Don't let this flag release before its parent. |
| A `policy` env resolves to guarded but has no relevant metric | Say so — a guarded rollout with no meaningful metric guards nothing. Recommend an immediate release, or point at metric setup. |
## What NOT to Do
- **Don't create the flag or edit code** — that's `launchdarkly-flag-create`. This skill only records the release.
- **Don't turn the flag on yourself, or toggle it after recording the config.** The rollout owns that; double-toggling causes audit noise and confuses the scheduler.
- **Don't skip `match-release-policies`.** Proposing `policy` without knowing what it resolves to is guessing.
- **Don't silently release against a stated hold/`notBefore`.** Honor intent or hold — never drop it.
- **Don't handle or print credentials.** Use the MCP server's OAuth and the user's existing git access; never read tokens from the machine.
## References
- [references/auto-release.md](references/auto-release.md): the automated-rollout / release-policy model, immediate vs `policy`, precedence (intent → override → policy → default), previewing, prerequisites, metric adequacy. *(Core of this skill.)*
- [`launchdarkly-guarded-rollout`](../launchdarkly-guarded-rollout/SKILL.md): for a *bespoke* rollout no policy expresses — record that env as immediate here and drive the guarded rollout by hand after merge.
© launchdarkly · Apache-2.0 · launchdarkly/ai-tooling