Communityコーディング&開発github.com

dris1153/upstream-sync

任意のGitリポジトリの上流(アップストリーム)の変更を、カスタマイズしたフォークに安全に同期します。カスタムコードを壊すことなく取り込めます。

upstream-sync とは?

**dris1153/upstream-sync** は、Gitリポジトリのフォークに対して、上流(アップストリーム)リポジトリの最新変更を、フォーク内のカスタムコードを壊さずに安全に同期するためのAIエージェントスキルです。このスキルは、フォークを長期メンテナンスする開発者やチームにとって特に有用で、上流のバグ修正や新機能を取得しつつ、自社固有のロジックや設定を保持できます。対応プラットフォームは明示されていませんが、汎用的なGit運用とAIエージェント(例:Claude Code, Cursor, GitHub Copilot等)との連携を想定し、ワークフローやスクリプトとして実装可能です。スキルの動作としては、まずフォークと上流リポジトリの差分を分析し、コンフリクトが発生する可能性のある変更を特定。次に、カスタムコードを保護しながら、上流の変更をマージするための安全な戦略を提案・実行します。これにより、手動でのマージ作業や複雑なコンフリクト解消の負担を大幅に軽減し、フォークの最新状態を簡単かつ安全に維持できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add dris1153/upstream-sync

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

upstream-sync は何をしますか?

任意のGitリポジトリの上流(アップストリーム)の変更を、カスタマイズしたフォークに安全に同期します。カスタムコードを壊すことなく取り込めます。

概要

このスキルは、Gitリポジトリのフォークを管理する開発者向けに設計されています。上流リポジトリの更新を、フォーク内の独自変更と競合することなく統合するためのプロセスを提供します。

使用方法

このスキルを使用するには、まずターゲットのフォークリポジトリと上流リポジトリを設定します。AIエージェントは以下の手順を自動化します:

  1. 上流リポジトリをリモートとして追加(まだの場合)
  2. 上流リポジトリの最新変更を取得
  3. フォークのブランチ(通常はmainまたはmaster)をチェックアウト
  4. 上流の変更をフォークにマージ
  5. コンフリクトが発生した場合、カスタムコードを優先して解決
  6. 変更をテストし、問題なければフォークにプッシュ

設定

変数名説明必須
UPSTREAM_URL上流リポジトリのURLはい
FORK_URLフォークリポジトリのURLはい
BRANCH同期対象のブランチ名(デフォルト: main)いいえ
BACKUP_BRANCHバックアップブランチ名(デフォルト: backup-before-sync)いいえ

注意事項

  • このスキルは自動的に変更をプッシュする前に、必ずテストを実行することを推奨します。
  • 大量のコンフリクトが予想される場合は、手動レビューを挟むことをお勧めします。
  • 上流リポジトリのライセンスと著作権に注意してください。

サポート

問題が発生した場合は、リポジトリのIssueトラッカーに報告してください。

関連スキル