project-archive-sync は何をしますか？
Windows上でのGit、GitHub/Gitea、HANDOFF.md、および2台のコンピュータ間プロジェクトハンドオフのための安全性最優先のCodexスキル。
概要
このスキルは、Windows環境において、AIエージェント（Codexなど）がプロジェクトを安全にアーカイブ、同期、およびハンドオフするための標準化された方法を提供します。特に、複数のコンピュータで作業する場合や、チームメンバーとプロジェクトを共有する場合に役立ちます。
機能
- 安全なGit操作: データ損失を防ぐための保護機能付きのGitコマンド。
- リモートリポジトリ管理: GitHubおよびGiteaとのシームレスな連携。
- HANDOFF.mdの生成と解析: プロジェクトの状態を明確に文書化。
- 2台のコンピュータ間ハンドオフ: ファイルパスと環境の違いを自動的に処理。
- Windows最適化: パス区切り文字、改行、権限などのWindows特有の問題に対応。
使用方法
- プロジェクトのアーカイブ:
project-archive-sync archiveを実行して、現在のプロジェクトを圧縮し、状態をHANDOFF.mdに記録します。 - プロジェクトの同期:
project-archive-sync syncを実行して、リモートリポジトリから最新の変更を取得し、ローカルと同期します。 - プロジェクトのハンドオフ:
project-archive-sync handoffを実行して、別のコンピュータにプロジェクトを転送するためのHANDOFF.mdを生成します。
要件
- Windows 10/11
- Git for Windows
- Codex（または互換性のあるAIエージェント）
- オプション: GitHubまたはGiteaアカウント
設定
環境変数または設定ファイルで以下のオプションを設定できます。
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
ARCHIVE_SYNC_REMOTE | リモートリポジトリのURL | なし |
ARCHIVE_SYNC_BRANCH | 使用するブランチ | main |
ARCHIVE_SYNC_HANDOFF_FILE | HANDOFFファイルのパス | HANDOFF.md |
注意事項
- このスキルは「安全性最優先」で設計されています。破壊的な操作（例:
git push --force）はデフォルトで無効化されています。 - 初めて使用する前に、テスト用のリポジトリで動作を確認することを推奨します。
- ファイルパスに日本語が含まれる場合、正しく処理されることを確認してください。