fix-conflicts
GitHub Pull Request の merge conflict を base branch の最新変更を取り込みながら解消し、検証して commit・push する skill。
Файлы2
Открыть в GitHubSKILL.mdskills/fix-conflicts/SKILL.md
GitHubFix Conflicts
この skill は明示的に呼び出された場合のみ使用する。
$fix-conflicts
$fix-conflicts pr#123
$fix-conflicts owner/repo#123
- 引数なし: 現在のブランチに対応する PR を対象にする
pr#<number>: 現在の repository の指定 PR を対象にするowner/repo#<number>: 指定 repository の PR を対象にする
この skill の呼び出し自体を、対象 PR に対する merge・コード変更・commit・push の許可として扱う。
Workflow
- 対象 PR と base branch、PR のブランチを特定する
- remote の最新状態を取得する
- base branch の最新変更を PR のブランチへ merge する
- 発生した conflict を確認する
- base 側と PR 側の変更意図を確認して conflict を解消する
- 関連するテスト・型チェック・lint・build を実行する
- merge を commit する
- PR のブランチへ push する
Conflict の解消
conflict は機械的に片側を採用せず、両方の変更内容を確認して解消する。
以下を確認する。
- base 側で何が変更されたか
- PR 側で何を変更しようとしているか
- 両方の変更を維持する必要があるか
- 既存の仕様や呼び出し側と矛盾しないか
ours / theirs の一括採用で解消してはいけない。
仕様判断が必要で、既存コードやテストから判断できない場合は推測で決めない。
修正
conflict 解消に必要な範囲だけ変更する。
- 無関係なリファクタリングを行わない
- conflict と関係のない仕様は変更しない
- 既存の設計・命名・テストパターンを優先する
merge によって新たな不整合が生じた場合は、その解消に必要な範囲で修正してよい。
検証
conflict 解消後は、変更箇所に関連する検証をする。
merge による変更がテスト・型・lint・build に影響する場合は、対応する検証も実行する。
- 関連テスト
- 型チェック
- lint
- build
実行できない検証がある場合は、可能な代替検証を行う。
Commit
base branch の取り込みによって生成される merge commit を使用する。
conflict 解消後に追加修正した場合は、別の commit に分けてよい。
追加 commit の message は Conventional Commits 形式にする。
<type>(<scope>): <subject>
Rules
- rebase は使用しない
- force push は行わない
- PR のブランチ以外へ push しない
- conflict を機械的に片側採用で解消しない
- 無関係な変更を commit に含めない
- Git の破壊的な操作を避ける
Completion
完了時に以下を短く報告する。
- 取り込んだ base branch
- 解消した conflict
- conflict 解消時に行った判断
- 実行したテスト・検証
- commit / push の結果