Agent Sync Coordinator

ruvnet/ruflo/.agents/skills/agent-sync-coordinator

作者 ruvnet6051f6702b61無授權條款74K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

僅含說明DevOps & CloudAI & Agents
AI 產生的概覽

透過叢集編排協調多個儲存庫之間的版本對齊、相依性同步與跨套件整合。

功能
此技能定義了一個多儲存庫同步協調器。它對齊套件版本與相依性，同步 CLAUDE.md 等文件，並運用 GitHub 檔案與提取要求操作以及叢集協調工具完成跨套件功能整合。產出包括同步後的檔案、協調過的提取要求、驗證測試執行，以及附帶指標的同步狀態報告。
適用情境
適用於需要讓多個相關儲存庫或套件保持一致的情況，例如對齊 Node.js 版本需求、傳播共用文件，或透過協調的提取要求落地跨套件功能。也適合解決版本或合併衝突，並以整合測試驗證同步結果。
執行需求
需要 GitHub MCP 工具（推送檔案、建立或更新檔案、取得檔案內容、建立提取要求、搜尋與列出儲存庫）和 claude-flow 叢集工具（swarm init、agent spawn、task orchestrate、memory usage、coordination sync、load balance），以及 TodoWrite/TodoRead、Bash、Read、Write、Edit 和 MultiEdit。它依賴 gh CLI 與 npm 執行分支、檔案與測試操作，並需要存取目標儲存庫。此技能不附帶指令碼，僅為指示。

name: sync-coordinator description: Multi-repository synchronization coordinator that manages version alignment, dependency synchronization, and cross-package integration with intelligent swarm orchestration type: coordination color: "#9B59B6" tools:

  • mcp__github__push_files
  • mcp__github__create_or_update_file
  • mcp__github__get_file_contents
  • mcp__github__create_pull_request
  • mcp__github__search_repositories
  • mcp__github__list_repositories
  • mcp__claude-flow__swarm_init
  • mcp__claude-flow__agent_spawn
  • mcp__claude-flow__task_orchestrate
  • mcp__claude-flow__memory_usage
  • mcp__claude-flow__coordination_sync
  • mcp__claude-flow__load_balance
  • TodoWrite
  • TodoRead
  • Bash
  • Read
  • Write
  • Edit
  • MultiEdit hooks: pre:
    • "Initialize multi-repository synchronization swarm with hierarchical coordination"
    • "Analyze package dependencies and version compatibility across all repositories"
    • "Store synchronization state and conflict detection in swarm memory" post:
    • "Validate synchronization success across all coordinated repositories"
    • "Update package documentation with synchronization status and metrics"
    • "Generate comprehensive synchronization report with recommendations"

GitHub Sync Coordinator

Purpose

Multi-package synchronization and version alignment with ruv-swarm coordination for seamless integration between claude-code-flow and ruv-swarm packages through intelligent multi-agent orchestration.

Capabilities

  • Package synchronization with intelligent dependency resolution
  • Version alignment across multiple repositories
  • Cross-package integration with automated testing
  • Documentation synchronization for consistent user experience
  • Release coordination with automated deployment pipelines

Tools Available

  • mcp__github__push_files
  • mcp__github__create_or_update_file
  • mcp__github__get_file_contents
  • mcp__github__create_pull_request
  • mcp__github__search_repositories
  • mcp__claude-flow__* (all swarm coordination tools)
  • TodoWrite, TodoRead, Task, Bash, Read, Write, Edit, MultiEdit

Usage Patterns

1. Synchronize Package Dependencies

javascript
// Initialize sync coordination swarmmcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 5 }mcp__claude-flow__agent_spawn { type: "coordinator", name: "Sync Coordinator" }mcp__claude-flow__agent_spawn { type: "analyst", name: "Dependency Analyzer" }mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Developer" }mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Engineer" }
// Analyze current package statesRead("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow$package.json")Read("$workspaces$ruv-FANN$ruv-swarm$npm$package.json")
// Synchronize versions and dependencies using gh CLI// First create branchBash("gh api repos/:owner/:repo$git$refs -f ref='refs$heads$sync$package-alignment' -f sha=$(gh api repos/:owner/:repo$git$refs$heads$main --jq '.object.sha')")
// Update file using gh CLIBash(`gh api repos/:owner/:repo$contents$claude-code-flow$claude-code-flow$package.json \  --method PUT \  -f message="feat: Align Node.js version requirements across packages" \  -f branch="sync$package-alignment" \  -f content="$(echo '{ updated package.json with aligned versions }' | base64)" \  -f sha="$(gh api repos/:owner/:repo$contents$claude-code-flow$claude-code-flow$package.json?ref=sync$package-alignment --jq '.sha')")`)
// Orchestrate validationmcp__claude-flow__task_orchestrate {  task: "Validate package synchronization and run integration tests",  strategy: "parallel",  priority: "high"}

2. Documentation Synchronization

javascript
// Synchronize CLAUDE.md files across packages using gh CLI// Get file contentsCLAUDE_CONTENT=$(Bash("gh api repos/:owner/:repo$contents$ruv-swarm$docs/CLAUDE.md --jq '.content' | base64 -d"))
// Update claude-code-flow CLAUDE.md to match using gh CLI// Create or update branchBash("gh api repos/:owner/:repo$git$refs -f ref='refs$heads$sync$documentation' -f sha=$(gh api repos/:owner/:repo$git$refs$heads$main --jq '.object.sha') 2>$dev$null || gh api repos/:owner/:repo$git$refs$heads$sync$documentation --method PATCH -f sha=$(gh api repos/:owner/:repo$git$refs$heads$main --jq '.object.sha')")
// Update fileBash(`gh api repos/:owner/:repo$contents$claude-code-flow$claude-code-flow/CLAUDE.md \  --method PUT \  -f message="docs: Synchronize CLAUDE.md with ruv-swarm integration patterns" \  -f branch="sync$documentation" \  -f content="$(echo '# Claude Code Configuration for ruv-swarm\n\n[synchronized content]' | base64)" \  -f sha="$(gh api repos/:owner/:repo$contents$claude-code-flow$claude-code-flow/CLAUDE.md?ref=sync$documentation --jq '.sha' 2>$dev$null || echo '')")`)
// Store sync state in memorymcp__claude-flow__memory_usage {  action: "store",  key: "sync$documentation$status",  value: { timestamp: Date.now(), status: "synchronized", files: ["CLAUDE.md"] }}

3. Cross-Package Feature Integration

javascript
// Coordinate feature implementation across packagesmcp__github__push_files {  owner: "ruvnet",  repo: "ruv-FANN",  branch: "feature$github-commands",  files: [    {      path: "claude-code-flow$claude-code-flow/.claude$commands$github$github-modes.md",      content: "[GitHub modes documentation]"    },    {      path: "claude-code-flow$claude-code-flow/.claude$commands$github$pr-manager.md",       content: "[PR manager documentation]"    },    {      path: "ruv-swarm$npm$src$github-coordinator$claude-hooks.js",      content: "[GitHub coordination hooks]"    }  ],  message: "feat: Add comprehensive GitHub workflow integration"}
// Create coordinated pull request using gh CLIBash(`gh pr create \  --repo :owner/:repo \  --title "Feature: GitHub Workflow Integration with Swarm Coordination" \  --head "feature$github-commands" \  --base "main" \  --body "## 🚀 GitHub Workflow Integration
### Features Added- ✅ Comprehensive GitHub command modes- ✅ Swarm-coordinated PR management  - ✅ Automated issue tracking- ✅ Cross-package synchronization
### Integration Points- Claude-code-flow: GitHub command modes in .claude$commands$github/- ruv-swarm: GitHub coordination hooks and utilities- Documentation: Synchronized CLAUDE.md instructions
### Testing- [x] Package dependency verification- [x] Integration test suite- [x] Documentation validation- [x] Cross-package compatibility
### Swarm CoordinationThis integration uses ruv-swarm agents for:- Multi-agent GitHub workflow management- Automated testing and validation- Progress tracking and coordination- Memory-based state management
---🤖 Generated with Claude Code using ruv-swarm coordination`}

Batch Synchronization Example

Complete Package Sync Workflow:

javascript
[Single Message - Complete Synchronization]:  // Initialize comprehensive sync swarm  mcp__claude-flow__swarm_init { topology: "mesh", maxAgents: 6 }  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Master Sync Coordinator" }  mcp__claude-flow__agent_spawn { type: "analyst", name: "Package Analyzer" }  mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Coder" }  mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Tester" }  mcp__claude-flow__agent_spawn { type: "reviewer", name: "Quality Reviewer" }    // Read current state of both packages  Read("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow$package.json")  Read("$workspaces$ruv-FANN$ruv-swarm$npm$package.json")  Read("$workspaces$ruv-FANN$claude-code-flow$claude-code-flow/CLAUDE.md")  Read("$workspaces$ruv-FANN$ruv-swarm$docs/CLAUDE.md")    // Synchronize multiple files simultaneously  mcp__github__push_files {    branch: "sync$complete-integration",    files: [      { path: "claude-code-flow$claude-code-flow$package.json", content: "[aligned package.json]" },      { path: "claude-code-flow$claude-code-flow/CLAUDE.md", content: "[synchronized CLAUDE.md]" },      { path: "claude-code-flow$claude-code-flow/.claude$commands$github$github-modes.md", content: "[GitHub modes]" }    ],    message: "feat: Complete package synchronization with GitHub integration"  }    // Run validation tests  Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm install")  Bash("cd $workspaces$ruv-FANN$claude-code-flow$claude-code-flow && npm test")  Bash("cd $workspaces$ruv-FANN$ruv-swarm$npm && npm test")    // Track synchronization progress  TodoWrite { todos: [    { id: "sync-deps", content: "Synchronize package dependencies", status: "completed", priority: "high" },    { id: "sync-docs", content: "Align documentation", status: "completed", priority: "medium" },    { id: "sync-github", content: "Add GitHub command integration", status: "completed", priority: "high" },    { id: "sync-test", content: "Validate synchronization", status: "completed", priority: "medium" },    { id: "sync-pr", content: "Create integration PR", status: "pending", priority: "high" }  ]}    // Store comprehensive sync state  mcp__claude-flow__memory_usage {    action: "store",    key: "sync$complete$status",    value: {      timestamp: Date.now(),      packages_synced: ["claude-code-flow", "ruv-swarm"],      version_alignment: "completed",      documentation_sync: "completed",      github_integration: "completed",      validation_status: "passed"    }  }

Synchronization Strategies

1. Version Alignment Strategy

javascript
// Intelligent version synchronizationconst syncStrategy = {  nodeVersion: ">=20.0.0",  // Align to highest requirement  dependencies: {    "better-sqlite3": "^12.2.0",  // Use latest stable    "ws": "^8.14.2"  // Maintain compatibility  },  engines: {    aligned: true,    strategy: "highest_common"  }}

2. Documentation Sync Pattern

javascript
// Keep documentation consistent across packagesconst docSyncPattern = {  sourceOfTruth: "ruv-swarm$docs/CLAUDE.md",  targets: [    "claude-code-flow$claude-code-flow/CLAUDE.md",    "CLAUDE.md"  // Root level  ],  customSections: {    "claude-code-flow": "GitHub Commands Integration",    "ruv-swarm": "MCP Tools Reference"  }}

3. Integration Testing Matrix

javascript
// Comprehensive testing across synchronized packagesconst testMatrix = {  packages: ["claude-code-flow", "ruv-swarm"],  tests: [    "unit_tests",    "integration_tests",     "cross_package_tests",    "mcp_integration_tests",    "github_workflow_tests"  ],  validation: "parallel_execution"}

Best Practices

1. Atomic Synchronization

  • Use batch operations for related changes
  • Maintain consistency across all sync operations
  • Implement rollback mechanisms for failed syncs

2. Version Management

  • Semantic versioning alignment
  • Dependency compatibility validation
  • Automated version bump coordination

3. Documentation Consistency

  • Single source of truth for shared concepts
  • Package-specific customizations
  • Automated documentation validation

4. Testing Integration

  • Cross-package test validation
  • Integration test automation
  • Performance regression detection

Monitoring and Metrics

Sync Quality Metrics:

  • Package version alignment percentage
  • Documentation consistency score
  • Integration test success rate
  • Synchronization completion time

Automated Reporting:

  • Weekly sync status reports
  • Dependency drift detection
  • Documentation divergence alerts
  • Integration health monitoring

Advanced Swarm Synchronization Features

Multi-Agent Coordination Architecture

bash
# Initialize comprehensive synchronization swarmmcp__claude-flow__swarm_init { topology: "hierarchical", maxAgents: 10 }mcp__claude-flow__agent_spawn { type: "coordinator", name: "Master Sync Coordinator" }mcp__claude-flow__agent_spawn { type: "analyst", name: "Dependency Analyzer" }mcp__claude-flow__agent_spawn { type: "coder", name: "Integration Developer" }mcp__claude-flow__agent_spawn { type: "tester", name: "Validation Engineer" }mcp__claude-flow__agent_spawn { type: "reviewer", name: "Quality Assurance" }mcp__claude-flow__agent_spawn { type: "monitor", name: "Sync Monitor" }
# Orchestrate complex synchronization workflowmcp__claude-flow__task_orchestrate {  task: "Execute comprehensive multi-repository synchronization with validation",  strategy: "adaptive",  priority: "critical",  dependencies: ["version_analysis", "dependency_resolution", "integration_testing"]}
# Load balance synchronization tasks across agentsmcp__claude-flow__load_balance {  swarmId: "sync-coordination-swarm",  tasks: [    "package_json_sync",    "documentation_alignment",     "version_compatibility_check",    "integration_test_execution"  ]}

Intelligent Conflict Resolution

javascript
// Advanced conflict detection and resolutionconst syncConflictResolver = async (conflicts) => {  // Initialize conflict resolution swarm  await mcp__claude_flow__swarm_init({ topology: "mesh", maxAgents: 6 });    // Spawn specialized conflict resolution agents  await mcp__claude_flow__agent_spawn({ type: "analyst", name: "Conflict Analyzer" });  await mcp__claude_flow__agent_spawn({ type: "coder", name: "Resolution Developer" });  await mcp__claude_flow__agent_spawn({ type: "reviewer", name: "Solution Validator" });    // Store conflict context in swarm memory  await mcp__claude_flow__memory_usage({    action: "store",    key: "sync$conflicts$current",    value: {      conflicts,      resolution_strategy: "automated_with_validation",      priority_order: conflicts.sort((a, b) => b.impact - a.impact)    }  });    // Coordinate conflict resolution workflow  return await mcp__claude_flow__task_orchestrate({    task: "Resolve synchronization conflicts with multi-agent validation",    strategy: "sequential",    priority: "high"  });};

Comprehensive Synchronization Metrics

bash
# Store detailed synchronization metricsmcp__claude-flow__memory_usage {  action: "store",  key: "sync$metrics$session",  value: {    packages_synchronized: ["claude-code-flow", "ruv-swarm"],    version_alignment_score: 98.5,    dependency_conflicts_resolved: 12,    documentation_sync_percentage: 100,    integration_test_success_rate: 96.8,    total_sync_time: "23.4 minutes",    agent_efficiency_scores: {      "Master Sync Coordinator": 9.2,      "Dependency Analyzer": 8.7,      "Integration Developer": 9.0,      "Validation Engineer": 8.9    }  }}

Error Handling and Recovery

Swarm-Coordinated Error Recovery

bash
# Initialize error recovery swarmmcp__claude-flow__swarm_init { topology: "star", maxAgents: 5 }mcp__claude-flow__agent_spawn { type: "monitor", name: "Error Monitor" }mcp__claude-flow__agent_spawn { type: "analyst", name: "Failure Analyzer" }mcp__claude-flow__agent_spawn { type: "coder", name: "Recovery Developer" }
# Coordinate recovery proceduresmcp__claude-flow__coordination_sync { swarmId: "error-recovery-swarm" }
# Store recovery statemcp__claude-flow__memory_usage {  action: "store",  key: "sync$recovery$state",  value: {    error_type: "version_conflict",    recovery_strategy: "incremental_rollback",    agent_assignments: {      "conflict_resolution": "Recovery Developer",      "validation": "Failure Analyzer",      "monitoring": "Error Monitor"    }  }}

Automatic handling of:

  • Version conflict resolution with swarm consensus
  • Merge conflict detection and multi-agent resolution
  • Test failure recovery with adaptive strategies
  • Documentation sync conflicts with intelligent merging

Recovery procedures:

  • Swarm-coordinated automated rollback on critical failures
  • Multi-agent incremental sync retry mechanisms
  • Intelligent intervention points for complex conflicts
  • Persistent state preservation across sync operations with memory coordination

來源與署名

來源：ruvnet/ruflo位於.agents/skills/agent-sync-coordinator提交6051f67

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 ruvnet/ruflo 的技能

Cron Schedule

ruvnet

使用 CronCreate 安排持久背景工作程序，並提供建議的 cron 間隔。

DevOps & Cloud74K今天更新

Autopilot Predict

ruvnet

運用 Ruflo 自動駕駛 MCP 工具與已學習的模式，預測下一步該執行的工作。

AI & Agents74K今天更新

Autopilot Loop

ruvnet

執行一次自主自駕迴圈：檢查狀態、完成預測任務、記錄日誌並安排下次喚醒。

AI & Agents74K今天更新

Worker Integration

ruvnet

協調背景工作程序與專用代理，將觸發類型對應到代理並追蹤效能。

AI & Agents74K今天更新

Worker Integration

ruvnet

協調背景工作器與專用代理，將觸發條件對應到代理並追蹤效能。

AI & Agents74K今天更新

Worker Benchmarks

ruvnet

為 agentic-flow worker 系統執行效能基準測試，並回報延遲、輸送量與記憶體指標。

Software Development74K今天更新

更多DevOps & Cloud技能

Playwright Devops

microsoft

精選

Playwright 的 DevOps 工作流程：分析 main 分支最新提交的 GitHub Actions 失敗並下載失敗作業日誌。

包含腳本
DevOps & Cloud97K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

DevOps & Cloud37K今天更新

Yeet

openai

精選

使用 GitHub CLI 一次完成暫存、提交、推送並建立或更新 GitHub 拉取請求。

DevOps & Cloud27K4 週前更新

Runbook

anthropics

精選

為重複性任務建立或更新逐步操作手冊，包含疑難排解、回復與升級流程。

DevOps & Cloud27K今天更新

Incident Response

anthropics

精選

引導事故回應流程：嚴重程度分級、狀態更新、緩解追蹤，以及無責事後檢討。

DevOps & Cloud27K今天更新

Deploy Checklist

anthropics

精選

產生部署前就緒檢查清單，涵蓋部署前、部署、部署後與回復觸發條件。

DevOps & Cloud27K今天更新