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

flow-next-tracker-sync — скилл для Claude Code

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

MIT ★ 730 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Открыть на GitHub

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

Какие задачи решает

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

Примеры запросов агенту

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

Как установить flow-next-tracker-sync

1Через маркетплейс плагинов

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

Команда ставит плагин flow-next целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flow-next-tracker-sync

Как установить flow-next-tracker-sync в Claude Code?

Добавьте маркетплейс: /plugin marketplace add gmickel/flow-next. Затем поставьте плагин: /plugin install flow-next@flow-next.

Что делает flow-next-tracker-sync?

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

Чем он отличается от /flow-next:sync?

/flow-next:sync — это plan-sync. Этот скилл работает с внешним трекером: создаёт задачу, связывает её со спекой и разбирает расхождения.

Исходный текст

SKILL.md · MIT
---
name: flow-next-tracker-sync
description: Project a flow-next spec to Linear, GitHub, GitLab, or Jira and reconcile body, status, and comments. Use for tracker discovery, linking, create-first, push, pull, reconcile, comment, or unlink. Not /flow-next:sync, which is plan-sync.
user-invocable: false
allowed-tools: AskUserQuestion, Read, Bash, Grep, Glob, Write, Edit
---

# flow-next-tracker-sync

The flow spec is the source of truth and quality layer. The tracker is a
co-editable projection. Tracker activity never starts agents or changes Flow
task state.

Read [working-rules.md](../../references/working-rules.md) first unless you already have this run; it holds for every step of this skill.

## Load the reached path

Read [steps.md](steps.md) for the operation sequence and
[references/adapter-interface.md](references/adapter-interface.md) for the
normalized contract. Load only references needed by the reached path:

- Body comparison or conflict:
  [references/body-merge.md](references/body-merge.md).
- Status projection: [references/status-sync.md](references/status-sync.md).
- Comment or question-valve content:
  [references/comments-sync.md](references/comments-sync.md).
- Hybrid identifiers: [references/identity.md](references/identity.md).
- Linear transport shape: [references/linear-ladder.md](references/linear-ladder.md),
  then only the reached MCP or GraphQL reference.
- GitHub, GitLab, or Jira transport shape: the matching provider reference only.

Never load an unselected provider merely because another reference links it.

## Deterministic boundary

`flowctl tracker` owns tracker transport, normalization, credentials, retries,
capability degradation, lifecycle ordering, receipts, and atomic local state.
The skill supplies only approved semantic inputs and reacts to the structured
result. Do not reconstruct provider requests in skill prose or shell.

Use the lifecycle facade for event-driven projection:

```bash
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
$FLOWCTL tracker sync "$SPEC_ID" --op "$OP" --event "$EVENT" \
  --flow-file "$FLOW_FILE" --body-file "$BODY_FILE" \
  --comments-file "$COMMENTS_FILE" --source-body-file "$SOURCE_BODY_FILE"
```

Pass only flags legal for the selected operation. [steps.md](steps.md) lists
the file contract. For discovery, create-first, link, unlink, status, relation,
attachment, and direct wire maintenance, use the matching `flowctl tracker`
verb. `flowctl tracker --help` is the executable source of truth.

Every command returns one JSON object on stdout. Success has `success: true`,
`data`, `degraded`, and `probe`. Failure has `success: false`, `class`, `error`,
`retryable`, and typed `details`. Branch on `class`, never provider text.

## Exactly five judgment surfaces

These are the only five surfaces intentionally retained in the host agent:

1. **MCP rung.** MCP tools exist only in the host tool environment, so flowctl
   cannot invoke them. The agent may perform the explicitly requested Linear
   MCP action, then hands the returned identity to `tracker persist-external`.
2. **Discovery ceremony.** Choosing a tracker, project or team, and enabling
   lifecycle events is an ambiguous one-time product decision. The agent
   surfaces detected choices and asks before persisting configuration.
3. **Body-merge conflict adjudication.** A three-way body conflict is semantic
   because equivalent prose, intent, and requirement meaning cannot be resolved
   from hashes or syntax alone. The agent adjudicates only conflicting sections,
   while flowctl owns snapshots and atomic persistence.
4. **Comment content synthesis.** Lifecycle comments communicate human context.
   The caller decides what the comment should say and supplies a stable
   occurrence identity as the first file line, `evidence=<token>`. Flowctl
   rejects missing/placeholder evidence, strips that line from visible content,
   and owns marker dedup, transport, and the receipt.
5. **Recovery routing from a structured error.** A typed conflict,
   `external_action_required`, or non-retryable capability result can require a
   user choice, an MCP continuation, a local correction, or a defer. The agent
   selects that next action from the structured envelope instead of parsing
   error prose.

No other tracker operation is agentic. In particular, request construction,
pagination, provider field mapping, status policy, relation projection,
comment dedup, credential selection, retry timing, and receipt writes remain
deterministic.

## Discovery ceremony

The bridge is off until the user confirms it; [steps.md](steps.md) §1 is the procedure. Every
discovery surfaces the provider signals, the proposed project or team, and the lifecycle defaults.
Credentials remain in the environment. Never copy credentials into config, a prompt, argv,
receipt, or error note.

Linear MCP is discovery/create only. All later shell-reachable operations use
the deterministic GraphQL route. If an MCP create returns only a display key,
`tracker persist-external` resolves and stores its durable identity.

## Operating rules

- One Flow spec maps to one tracker issue. Tasks remain Flow-local.
- Tracker-first creation uses the hybrid identifier rules in `identity.md`.
  Never rename an existing Flow-first spec.
- Callers retain their bridge-active and `perEvent` gates. An inactive bridge
  remains silent because the lifecycle facade is not invoked.
- Event-driven callers use `tracker sync`, not granular tracker verbs.
- Comment text and merged body text travel through mode `0600` temporary files,
  never argv. Delete temporary files after the call.
- The facade writes one aggregate receipt. Do not add a second receipt.
- A pull or reconcile may update Flow prose, but never Flow task status.
- Dependency projection is additive and provenance-led. Never delete or
  recreate a user-controlled relation without evidence that Flow owns it.
- `inactive` is a silent no-op for lifecycle callers.
- `rate_limited` is retried only when the envelope says `retryable: true`.
- `auth`, `unresolved`, `stale_id`, `conflict`, `capability`, and
  `external_action_required` follow the recovery table in `steps.md`.
- In any unattended run (a stage `flow --auto` dispatched, any
  `mode:autonomous` caller) or a forked lifecycle call, queue a decision that
  needs a person with `flowctl sync defer`. Never attempt an interactive prompt
  there.

## Boundaries

This skill is projection, not coordination. `/flow-next:tracker-sync` is
distinct from `/flow-next:sync`. Flow state remains authoritative. Provider
wire details live in deterministic Python; the Markdown references document
their shapes so reviewers can inspect the contract without copying executable
transport recipes into prompts.

© Gordon Mickel · MIT · gmickel/flow-next

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
gitkraken GitKraken Плагин gitkraken подключает контекст Git и трекеров к Claude Code: коммиты, ветки, пулл-реквесты и задачи. Помогает разбирать историю проектов в GitHub, GitLab, Jira и других системах. gk-cli gitkraken gk-cli — MCP-сервер для Claude Code, который связывает агента с Git и GitKraken. Он помогает работать с репозиториями, задачами и pull request. CX Codex +1 ★ 466звёзд репо log davila7 Команда /orchestration/log в Claude Code отправляет отчёты о выполненных задачах в Linear, Obsidian, Jira или GitHub Issues. Запускается вручную после завершения задачи или в конце дня для сводки. CX Codex +1 351установок project-management miles990 Скилл project-management обучает ассистента методологиям Scrum и Kanban, шаблонам задач для GitHub и Linear, а также оценке историй в Story Points. CX Codex +1 399установок track-findings официальный OpenAI Скилл track-findings для Codex заносит подтверждённые находки Codex Security в Linear, Jira, GitHub или черновики advisory. Он включается после проверки результатов сканирования. CX Codex GP ChatGPT +1 26установок SHIP letsship MCP-сервер SHIP подключает AI-ассистента к фабрике агентов, которые планируют задачи из GitHub, Linear или Jira, пишут код, запускают тесты и готовят пулл-реквесты. CX Codex +1

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

Весь набор →
github-scout Субагент github-scout для Claude Code ищет на GitHub примеры кода, реализации библиотек и открытые issues. Находит решения для изучения перед написанием своего кода. CX Codex ★ 730звёзд репо flow-next-prospect Скилл flow-next-prospect для Claude Code придумывает и ранжирует идеи развития на основе файлов репозитория. Запускается по просьбе обсудить, что строить дальше. CX Codex +1 ★ 730звёзд репо flow-next-map Скилл flow-next-map оборачивает clawpatch map, чтобы построить индекс функций и модулей репозитория на ~20 языках. По умолчанию работает без LLM-вызовов. CX Codex +1 ★ 730звёзд репо security-scout Субагент security-scout проверяет настройки безопасности репозитория GitHub, защиту веток, CODEOWNERS и автообновление зависимостей перед запуском агентов. CX Codex ★ 730звёзд репо claude-md-scout Субагент claude-md-scout оценивает содержательность файлов CLAUDE.md и AGENTS.md по шкале из восьми пунктов, проверяя наличие реальных команд и проектных правил перед стартом работы. CX Codex ★ 730звёзд репо flow-gap-analyst Субагент flow-gap-analyst разбирает краткое описание функции и находит пробелы, неоднозначности и пограничные случаи. Он помогает собрать вопросы, на которые нужно ответить до начала разработки. CX Codex ★ 730звёзд репо flow-next-deps Скилл flow-next-deps для Claude Code показывает граф зависимостей спеков, порядок выполнения и цепочки блокировок. Помогает определить, что заблокировано и в каком порядке запускать спеки. CX Codex +1 ★ 730звёзд репо flow-next-plan-review Скилл flow-next-plan-review для Claude Code направляет проверку спецификаций и планов через выбранный бэкенд и запускает цикл исправлений и повторного ревью. Проверяет Flow-документы. CX Codex +1 ★ 730звёзд репо

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

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