gh-issue-fix-flow

Gh Issue Fix Flow

概要

gh、ローカルでの編集、XcodeBuildMCP、git を使って、GitHub の issue を受け付けから修正、検証、プッシュまで進めます。

ワークフロー

1) 受付と issue のコンテキスト確認

1. gh issue view <id> --repo <owner/repo> --comments を使って、issue のコンテキスト全体を取得します。
2. リポジトリが不明な場合は、gh repo view --json nameWithOwner を実行して確認します。
3. 再現手順、期待される動作、メンテナーからのメモを記録します。

2) コードパスの特定

1. rg -n を使って、関連する可能性のあるファイルとエントリーポイントを特定します。
2. sed -n または rg -n のコンテキスト表示を使って、関連するコードパスを確認します。
3. リポジトリ固有の規約（AGENTS/CLAUDE の指示）に従います。

3) 修正の実装

1. 編集するファイルは必要最小限にします。
2. 変更内容を既存のアーキテクチャとスタイルに沿わせます。
3. 動作を変更する場合は、実用的な範囲でテストを追加します。

4) ビルドとテスト

1. 必要なビルド／テストには XcodeBuildMCP を使います。
   • デフォルトを一度だけ設定します：mcp__XcodeBuildMCP__session-set-defaults。
   • ビルド：mcp__XcodeBuildMCP__build_macos または mcp__XcodeBuildMCP__build_sim。
   • テスト：対象を絞ったスキームを優先します（例：mcp__XcodeBuildMCP__test_sim）。
2. デプロイメントターゲットの不一致が原因で macOS テストが失敗する場合は、同等の iOS シミュレーターテストを実行します。
3. 警告や失敗を報告し、隠さないでください。

5) コミットとプッシュ

1. git status --short で無関係な変更がないか確認します。
2. 修正分のみをステージします（無関係なファイルは除外します）。
3. クローズメッセージを付けてコミットします：Fix … (closes #<issue>)。
4. git push でプッシュします。

6) 結果の報告

1. 変更内容と変更箇所を要約します。
2. テスト結果（失敗も含む）を提示します。
3. 今後の対応事項やブロックされている項目があれば記載します。