chasenchen211/git-to-github-mirror

git-to-github-mirror は何をしますか？

Codexスキルによる一方向のGitHubミラーリング：ChatGPT分析とCodex実行のためにプロジェクトのコンテキストを維持します。

概要

このスキルは、CodexエージェントがプロジェクトのコードベースをGitHubの指定リポジトリに一方向でミラーリングする機能を提供します。ミラーリングにより、AI分析や自動タスク実行に最新のコードコンテキストが常に利用可能になります。

主な機能

• 一方向ミラーリング: ソースリポジトリからGitHubターゲットリポジトリへの安全なバックアップ。
• コンテキスト維持: ChatGPTやCodexが常に最新のプロジェクトコンテキストにアクセスできるようにします。
• 自動トリガー: CI/CDパイプラインとの統合や手動トリガーをサポート。
• 差分検出: 変更のみを効率的に転送します。
• 安全な認証: GitHub Personal Access TokenやSSHキーを使用した認証。

前提条件

• Codexエージェント環境（例：OpenAI Codex CLI）。
• 有効なGitHubアカウントとターゲットリポジトリ。
• GitHub Personal Access Token（repo権限が必要）またはSSHキー。

セットアップ

1. 環境変数の設定

   export GITHUB_TOKEN="your_personal_access_token"
   export GITHUB_USERNAME="your_username"
   export TARGET_REPO="your-target-repo"
   export SOURCE_REPO_PATH="/path/to/local/repo"
   

2. ターゲットリポジトリの初期化

   ターゲットリポジトリが存在し、空であることを確認してください。

3. スキルの有効化

   Codexエージェント内でこのスキルを設定し、適切な権限を付与します。

使用法

ミラーリングの実行

以下のコマンドをCodexエージェントに送信します：

実行：git-to-github-mirror をソース "$SOURCE_REPO_PATH" からターゲット "$GITHUB_USERNAME/$TARGET_REPO" に

スケジュール設定

cronジョブやCIパイプラインを設定して定期的にミラーリングを実行します：

# .github/workflows/mirror.yml の例
name: Mirror to GitHub
on:
  schedule:
    - cron: '0 */6 * * *'  # 6時間ごと
  workflow_dispatch:

jobs:
  mirror:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run mirror skill
        run: codex run git-to-github-mirror

セキュリティ

• トークンは定期的にローテーションしてください。
• 権限は最小限に設定してください（例：読み取り専用ミラーの場合はrepo）。
• 機密データをリポジトリにプッシュしないでください。

トラブルシューティング

• 認証エラー: GITHUB_TOKENが正しく設定され、有効であることを確認してください。
• 競合: 一方向ミラーリングでは強制プッシュ（git push --force）が使用されるため、ターゲットリポジトリへの直接コミットは避けてください。
• サイズ制限: 大きなリポジトリの場合は、GitHubのファイルサイズ制限（ファイルあたり100MB）を確認してください。

関連リソース

• Codexドキュメント
• GitHubミラーリングガイド

ライセンス

このスキルはMITライセンスの下で提供されます。