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

bidirectional-sync — команда для Claude Code: обзор и установка

Настраивает двустороннюю синхронизацию между задачами в GitHub Issues и Linear. Помогает разрешать конфликты правок и отслеживать состояние через локальные файлы.

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓
npx claude-code-templates@latest --command sync/bidirectional-sync
Открыть на GitHub

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

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

.claude/commands/bidirectional-sync.md

Вызов — /bidirectional-sync. Для всех проектов — ~/.claude/commands/

Вопросы о 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

Похожие слэш-команды

Все слэш-команды по теме «Заметки, задачи и проекты» →

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

Весь набор →
publisher-medium Превращает пост из markdown, PDF или URL в HTML, готовый к вставке в редактор Medium, и помечает места для загрузки картинок. 134установок burp-suite-testing Помогает настроить перехват трафика, исследовать HTTP-запросы и находить уязвимости веб-приложений через Burp Suite. 133установок paper-2-web Превращает научную статью в LaTeX или PDF в интерактивный сайт, постер для конференции и презентационное видео. Пригодится перед докладом или для продвижения препринта. 133установок task-from-pr Разбирает пул-реквест на GitHub и заводит по нему задачу в Linear: с оценкой сложности, привязкой к команде и ссылками в обе стороны. 133установок performance-profiling Скилл для Claude, который ведёт агента по шагам: замер, поиск узкого места, правка, проверка результата. Пригодится, когда страница грузится медленно. 132установок sync-status Проверяет синхронизацию между GitHub и Linear, собирает метрики очередей и ошибок. Пригодится при отладке интеграции задач. 132установок zapier-workflows Связывает Claude Code со сценариями Zapier через вебхуки и сохраняет выбор MCP-инструментов между сессиями. Пригодится для запуска рутинных цепочек прямо из терминала. 129установок llm-app-patterns Скилл даёт схемы для RAG-приложений и ИИ-агентов. Используйте его при проектировании поиска по документам или выборе архитектуры агента. 129установок

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

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