Плагин для Claude Code
Управление задачами, синхронизация флагов и ревью feature flags прямо в Claude Code
FlipFlag предоставляет плагин для Claude Code, который добавляет команды для управления задачами, синхронизации флагов с платформой и ревью кода с feature flags.
Предварительные требования
Установите FlipFlag CLI глобально:
npm install -g @flipflag/cliУстановка плагина
Вариант 1: Через Claude Marketplace
claude /plugin marketplace add flipflag-dev/claude-marketplaceВариант 2: Локально из репозитория
git clone https://github.com/flipflag-dev/claude-marketplace.git
claude --plugin-dir /path/to/claude-marketplaceВариант 3: Скопировать в проект
Скопируйте содержимое плагина в директорию .claude/ вашего проекта.
Компоненты плагина
| Компонент | Тип | Описание |
|---|---|---|
/flipflag | Команда | Старт/стоп задач, синхронизация флагов и управление ветками |
/ff-status | Команда | Просмотр статуса задач из .flipflag.yml |
feature-flag-reviewer | Агент | Ревью кода на правильное использование FlipFlag SDK |
flipflag-cli | Скилл | Управление задачами через CLI |
remove-feature-flag | Скилл | Удаление полностью раскатанного флага из кодовой базы |
Команда /flipflag
Начать работу над задачей
# Старт задачи
/flipflag start EMD-1234
# С указанием типа
/flipflag start EMD-1234 --type=bugfix
# Без создания git-ветки
/flipflag start EMD-1234 --no-branchОстановить задачу
# Остановить конкретную задачу
/flipflag stop EMD-1234
# Остановить текущую задачу (определяется из имени ветки)
/flipflag stopСинхронизировать флаги с платформой
# Синхронизация с явным ключом
/flipflag sync --private-key "your_private_key"
# Через переменную окружения
FLIPFLAG_PRIVATE_KEY=your_key /flipflag sync
# Для self-hosted инстанса
/flipflag sync --private-key KEY --api-url https://your-instance.example.comКоманда /ff-status
Показывает статус задач и информацию о контрибьюторе.
# Все задачи
/ff-status
# Конкретная задача
/ff-status EMD-1234Скилл /remove-feature-flag
Удаляет полностью раскатанный feature flag из кодовой базы, оставляя только ветку включённого состояния. Используется для очистки кода после того, как флаг окончательно выкатан на всех пользователей.
Агент feature-flag-reviewer
Агент запускается при ревью кода и проверяет правильность использования FlipFlag SDK.
Что проверяется:
- React SDK: хуки
useFlag(),useFlags(),useFlipFlagReady() - Node.js SDK:
FlipFlagCore,isEnabled(),init(),destroy() - Консистентность именования флагов
- Покрытие обоих путей — включённого и выключённого
- Мёртвый код от удалённых флагов
Git-ветки
Плагин автоматически создаёт ветки по следующему формату:
| Тип задачи | Формат ветки |
|---|---|
| feature | feature/TASK-ID |
| bugfix | bugfix/TASK-ID |
Автоопределение задачи из ветки:
feature/EMD-1234→EMD-1234bugfix/TASK-567→TASK-567EMD-999-some-description→EMD-999
Тип задачи определяется автоматически: если в идентификаторе есть bug, fix или hotfix — тип bugfix, иначе — feature.
Конфигурация
Плагин хранит метаданные задач в файле .flipflag.yml:
EMD-3200:
description: ""
contributor: "dev@example.com"
type: "feature"Дополнительные материалы
- FlipFlag CLI — использование CLI без интеграции с Claude Code
- FlipFlag SDK — клиентская библиотека для работы с флагами
- Интеграция с CI/CD — автоматическая синхронизация флагов в пайплайне