Git

• リポジトリタスク: Git リポジトリに関わるあらゆる作業 — ブランチの作成、変更のステージング、コミット、プッシュ、プルリクエストの作成など。
• チームコラボレーション: 履歴の安全性が重要で、フィーチャーブランチフロー、ホットフィックスワークフロー、またはPR対応のコミット規律を自動的に適用する必要がある場合。
• 履歴のデバッグ: git bisect でリグレッションを追跡したり、git reflog で失われたコミットを復元したり、変更を安全に元に戻す必要がある場合。
• コンフリクトの解消: マージやリベースでコンフリクトが発生し、エージェントがそれを解決するための構造化された検証済みのアプローチを必要とする場合。

• Git以外のバージョン管理: プロジェクトがMercurial、SVN、または他のVCSを使用している場合、このスキルのコマンドは適用されません。
• 読み取り専用の分析タスク: エージェントがGitと一切やり取りせずにソースコードを読み取るだけでよい場合、このスキルは不要なオーバーヘッドを追加します。

このスキルは、チームメンバーの作業を上書きしないよう、--force の代わりに --force-with-lease を使用することを強制し、main/master などの共有ブランチへのフォースプッシュを禁止します。reset --hard や rebase などの破壊的な操作を行う前に、組み込みの安全チェックリストをすべて満たす必要があります。

フィーチャーブランチおよびホットフィックスのシナリオに向けたステップバイステップのフローを含み、コミットをスカッシュするタイミング、git fetch --all --prune を使った同期方法、およびリリースへのタグ付け方法を網羅しています。トランクベース開発および gitflow スタイルの両方のチームに対応するよう設計されています。

コンフリクトが発生したファイルを編集した後、このスキルはgrepを使用してコンフリクトマーカーが残っていないことを確認し、コードがビルドできることを検証します。また、マージが複雑になりすぎた場合にgit merge --abortによる回避手段を提供します。マージが煩雑になった場合の代替手段として、リベースが推奨されます。

失われたコミットの復元（最大約90日間）に使用する git reflog、SHAによる削除済みブランチの復元、git reset --soft を使った作業内容を失わないコミットの取り消しについて解説します。また、リグレッションを引き起こしたコミットを特定するための git bisect のワークフロー全体も含まれています。

このスキルは、type(scope): description というコミットメッセージの形式を必須とし、最初の行を72文字以内に収めることを求めます。使用できるタイプは標準的なもの（feat、fix、docs、refactor など）に限定されます。これにより、履歴の可読性が保たれ、自動チェンジログツールとの互換性も確保されます。

Gitで頻繁に発生する落とし穴を記録し、対策を講じます。具体的には、detached HEAD状態、macOS/WindowsとLinux CI間の大文字・小文字の扱いの違い、サブモジュールのクローンエラー、stash-popによるコンフリクト、大容量ファイルや機密情報のコミットなどが挙げられます。細かい単位で部分的にステージングするには git add -p を活用してください。

エージェントが新しいフィーチャーの雛形を作成し、main からブランチを作成して、コンベンショナルなメッセージで段階的にコミットし、プッシュ前に最新の main へリベースし、fixupコミットをスカッシュして、PRの準備が整ったブランチを開きます — すべてGitへの手動介入なしで行われます。

本番環境でバグが発見された際、エージェントは main から hotfix/ ブランチをチェックアウトし、修正を適用した後、main と develop の両方にマージし、リリースにタグを付けてブランチを削除します。これはドキュメント化されたホットフィックスフローに正確に従った手順です。

エージェントはgit bisectを実行してコミット履歴を二分探索し、自動テストの結果に基づいてコミットを「良好」または「不良」としてマークしながら、バグを引き起こした正確なコミットを特定します。

長期にわたるフィーチャーブランチのリベース中、エージェントはファイルごとにコンフリクトを解決し、<<</>>> マーカーが残っていないことを確認し、ビルドが成功することを検証してからリベースを続行します。コンフリクトが複雑すぎる場合は、クリーンな状態でリベースを中止します。