bidirectional-sync — команда для Claude Code: обзор и установка
Настраивает двустороннюю синхронизацию между задачами в GitHub Issues и Linear. Помогает разрешать конфликты правок и отслеживать состояние через локальные файлы.
npx claude-code-templates@latest --command sync/bidirectional-syncЧто делает bidirectional-sync
Команда разворачивает двусторонний обмен данными между задачами GitHub Issues и Linear. В работе она опирается на консольную утилиту gh для проверки авторизации в GitHub и проверяет доступность Linear MCP. Текущее состояние синхронизации сохраняется в файле .sync-state.json или директории sync/.
Сценарий поддерживает несколько стратегий разрешения конфликтов: NEWER_WINS, GITHUB_WINS, LINEAR_WINS или объединение на уровне отдельных полей. Для защиты данных используются атомарные транзакции, распределённые блокировки и защита от зацикливания вебхуков.
Без авторизованного GitHub CLI и настроенного сервера Linear MCP синхронизация завершится ошибкой.
Какие задачи решает
- связать задачи GitHub Issues с карточками в Linear
- предотвратить зацикливание обновлений при обработке вебхуков
- устранить конфликты параллельных правок по правилу
NEWER_WINS - проверить изменения без записи через флаг
--dry-run
Примеры запросов агенту
- /bidirectional-sync --dry-run
- /bidirectional-sync --incremental --conflict-strategy NEWER_WINS
- /bidirectional-sync --full
Как установить bidirectional-sync
1Через claude-code-templates
npx claude-code-templates@latest --command sync/bidirectional-sync2Вручную: положить файлы
.claude/commands/bidirectional-sync.mdВызов — /bidirectional-sync. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/bidirectional-sync.mdВызов — /prompts:bidirectional-sync. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/bidirectional-sync.prompt.mdВручную: положить файлы
.gemini/commands/bidirectional-sync.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о bidirectional-sync
Как установить bidirectional-sync в Claude Code?
Запустите npx claude-code-templates@latest --command sync/bidirectional-sync в терминале или сохраните файл команды в .claude/commands/bidirectional-sync.md.
Что делает команда bidirectional-sync?
Она организует синхронизацию задач между GitHub Issues и Linear, отслеживает историю изменений и разрешает нестыковки данных.
Что нужно для работы этой команды?
Требуется авторизация в утилите gh и подключённый сервер Linear MCP. Данные о сопоставлении сущностей хранятся в .sync-state.json.
Исходный текст
bidirectional-sync.md · MIT
---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[sync-mode] | --full | --incremental | --dry-run | --conflict-strategy"
description: Enable comprehensive bidirectional GitHub-Linear synchronization with conflict resolution
---
# Bidirectional Sync
Enable comprehensive bidirectional GitHub-Linear synchronization: **$ARGUMENTS**
## Current Sync Environment
- GitHub status: !`gh api user 2>/dev/null && echo "✓ Authenticated" || echo "⚠ Not authenticated"`
- Linear MCP: Check if Linear MCP server is available and configured
- Sync state: @.sync-state.json or @sync/ (if exists)
- Webhooks: !`gh api repos/{owner}/{repo}/hooks 2>/dev/null | grep -c linear || echo "0"`
## Task
Implement robust bidirectional synchronization between GitHub Issues and Linear tasks:
**Sync Mode**: Use $ARGUMENTS to specify full sync, incremental sync, dry-run preview, or conflict resolution strategy
**Synchronization Framework**:
1. **Sync State Management** - Initialize sync database, track entity relationships, maintain sync history
2. **Conflict Detection** - Identify simultaneous changes, field-level conflicts, timing issues
3. **Resolution Strategies** - NEWER_WINS, GITHUB_WINS, LINEAR_WINS, or intelligent field-level merge
4. **Transaction Management** - Atomic operations, rollback capability, distributed locking
5. **Webhook Integration** - Real-time event handling, sync loop prevention, automated triggers
6. **Data Integrity** - Bidirectional validation, cross-reference maintenance, audit trails
**Advanced Features**: Field-level merge rules, sync loop prevention, webhook automation, performance optimization, comprehensive monitoring.
**Production Ready**: Transaction safety, conflict resolution, error recovery, performance monitoring, comprehensive logging.
**Output**: Complete bidirectional sync system with conflict resolution, webhook integration, performance metrics, and comprehensive sync reporting.
© davila7 · MIT · davila7/claude-code-templates