К основному содержанию
скилл CX Codex

flag-release — скилл для Claude Code: автоматический релиз feature-флага

Скилл flag-release для Claude Code, Codex, Cursor и других агентов фиксирует автоматический роллаут существующего LaunchDarkly-флага, чтобы изменение вышло после мержа PR без ручного переключения.

Apache-2.0 275 установок ★ 32 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add launchdarkly/ai-tooling --skill flag-release -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/flag-release/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flag-release/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
Feature Flag Rollout taste f Промпт Feature Flag Rollout taste для ChatGPT и Claude.ai формулирует правила и инженерные привычки по выкатке фиче-флагов. Задаёт чёткие критерии разделения деплоя и релиза новой функциональности. GP ChatGPT ★ 178 201звёзд репо launchdarkly-flag-cleanup официальный github Субагент launchdarkly-flag-cleanup проверяет фиче-флаги через MCP-сервер LaunchDarkly, определяет безопасное значение по продакшену и вырезает устаревшие ветки кода с оформлением пулреквеста. CX Codex +1 171установок feature-flags devops-skills Скилл feature-flags для Claude Code и Codex — управление выкатками фич через LaunchDarkly, Unleash или собственное решение. Запускает новые возможности постепенно, проводит A/B-тесты и откатывает фичи в продакшене без переразвёртывания. CX Codex +1 365установок feature-flags-architect Alireza Rezvani Плагин feature-flags-architect выстраивает дисциплину работы с фича-флагами: отслеживает технический долг, строит графики поэтапного релиза и проверяет наличие аварийных выключателей. ★ 30 251звёзд репо release-automation-builder patricio0312rev Скилл release-automation-builder для Claude Code настраивает автоматические релизы и публикацию пакетов. Запускается по запросам о версиях, журнале изменений или выпуске пакета. CX Codex +1 265установок tendril-release Ivy-Interactive Скилл tendril-release автоматизирует подготовку и публикацию релизов Ivy Tendril. Обновляет пакеты NuGet, собирает проект, делает PR в ветку main и запускает workflow в GitHub Actions. CX Codex +1 ★ 203звёзд репо

Из того же набора50

Весь набор →
create-graph Скилл create-graph для Claude Code и Codex строит графики наблюдаемости и дашборды по логам, метрикам, трейсам и ошибкам. Запрашивает ключи, показывает предпросмотр диаграммы и добавляет её на дашборд. CX Codex +1 708установок create-fix-pr Скилл create-fix-pr для Claude Code ищет первопричину сбоя по трассировкам или логам и готовит минимальный pull request в GitHub. Закрывает точечные баги без лишнего рефакторинга. CX Codex +1 702установок alert-investigation Скилл alert-investigation для Claude Code, Codex и Cursor разбирает сработавшие алерты в мониторинге. Анализирует метрики через LaunchDarkly MCP и отделяет системный шум от реального инцидента. CX Codex +1 700установок should-flag-change Скилл should-flag-change смотрит на диф и окружающий код и говорит, стоит ли прятать изменение за фича-флагом LaunchDarkly. Только совет: сам флаги не создаёт и не переключает. CX Codex +1 278установок flag-and-release-change Скилл flag-and-release-change для Claude Code ведёт изменение в PR от решения о флаге до автоматического релиза. Работает с флагом LaunchDarkly и веткой PR. CX Codex +1 267установок launchdarkly-flag-drift Скилл launchdarkly-flag-drift для Claude Code выявляет расхождения между запасным значением флага в коде и правилом по умолчанию в LaunchDarkly. Помогает обновить дефолтные аргументы SDK без удаления проверок флага. CX Codex +1 259установок launchdarkly-flag-qualitative-feedback-setup Скилл launchdarkly-flag-qualitative-feedback-setup добавляет сбор отзывов о вариантах feature flag в JavaScript/TypeScript-проект. Он нужен для виджета Give Feedback и события $ld:feedback. CX Codex +1 217установок launchdarkly Помогает управлять фиче-флагами LaunchDarkly и настраивать конфигурации AgentControl прямо из сессии Claude Code. ★ 32звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой