# flow-next-tracker-sync

Скилл flow-next-tracker-sync проецирует спеку flow-next в задачу Linear, GitHub, GitLab или Jira и сверяет тело, статус и комментарии. Спека остаётся источником правды.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 730 у репозитория
- Автор: Gordon Mickel
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/skills/flow-next-tracker-sync/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/flow-next-tracker-sync

## Что делает

Скилл берёт спеку flow-next как источник правды и проецирует её в задачу трекера: Linear, GitHub Issues, GitLab или Jira. Тело, статус и комментарии сверяются в обе стороны. Активность в трекере не запускает агентов и не меняет состояние задач Flow.

Работа с провайдерами лежит на `flowctl tracker`: транспорт, нормализация полей, креды, ретраи, записи-квитанции. Агент добавляет только смысловые входы. Пять мест оставлены человеку и агенту — вызовы через Linear MCP, разовая церемония discovery, разбор трёхстороннего конфликта тела, текст комментария и выбор шага восстановления после типизированной ошибки. Мост выключен, пока вы не подтвердите провайдера, проект и события жизненного цикла.

Скрипт ищется в `${CLAUDE_PLUGIN_ROOT}/scripts/flowctl` или `.flow/bin/flowctl`; без `flowctl` скилл ничего не сделает. Комментарии и тела уходят через временные файлы с правами `0600`, не через argv. Это не `/flow-next:sync` — та команда про plan-sync.

## Требования
- Работает с: GitHub, GitLab, Jira

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add gmickel/flow-next
```
В чате агента (не в терминале):
```text
/plugin install flow-next@flow-next
```
Команда ставит плагин flow-next целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add gmickel/flow-next --skill flow-next-tracker-sync -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/flow-next-tracker-sync/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/flow-next-tracker-sync/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gmickel/flow-next --skill flow-next-tracker-sync -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/flow-next-tracker-sync/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gmickel/flow-next --skill flow-next-tracker-sync -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/flow-next-tracker-sync/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gmickel/flow-next plugins/flow-next/skills/flow-next-tracker-sync
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/flow-next-tracker-sync/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gmickel/flow-next --skill flow-next-tracker-sync -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/gmickel/flow-next --path plugins/flow-next/skills/flow-next-tracker-sync
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/flow-next-tracker-sync/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gmickel/flow-next/tree/HEAD/plugins/flow-next/skills/flow-next-tracker-sync/SKILL.md

## Когда брать
- связать спеку flow-next с задачей в Linear и сохранить связь
- протолкнуть правки тела спеки в Jira, не тронув статус задач Flow
- разобрать трёхсторонний конфликт в теле задачи при pull
- оставить комментарий к задаче так, чтобы он не задвоился
- отвязать спеку от задачи, не снеся чужие связи

## Примеры запросов агенту
- Свяжи текущую спеку с задачей в Linear и покажи, какой проект предлагаешь
- Выгрузи тело спеки в Jira и разбери конфликт в разделе с требованиями
- Подтяни статусы из GitHub Issues и сверь их со спекой

## Похожие
- [gitkraken](https://affpapa.org/nevibecode/plugins/gitkraken.md) — плагин
- [gk-cli](https://affpapa.org/nevibecode/mcp/gk-cli.md) — MCP-сервер · ★ 466 у репозитория
- [log](https://affpapa.org/nevibecode/commands/log.md) — команда · 351 установка
- [project-management](https://affpapa.org/nevibecode/skills/project-management.md) — скилл · 399 установок
- [track-findings](https://affpapa.org/nevibecode/skills/track-findings.md) — скилл · 26 установок
- [SHIP](https://affpapa.org/nevibecode/mcp/ship.md) — MCP-сервер

Из того же набора: [gmickel/flow-next](https://affpapa.org/nevibecode/by/gmickel/flow-next.md) — 70 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
