Version Sync

Version Sync Skill

go.mod と go.sum の整合性をチェック・修正し、依存関係のバージョン不整合を解消します。

使用タイミング

• /version-sync コマンドを実行した時
• Go依存関係のアップグレード作業前
• CIが go.mod / go.sum 不整合エラーで落ちた時
• パッケージ追加後の整合性確認
• メンテナンス作業時の定期確認

実行手順

1. 現在の整合性確認

go mod verify

出力例：

• 正常: 何も出力されない（終了コード 0）
• エラー: hash mismatch 等のエラーメッセージ

2. 整合性チェックと修正

# 整合性チェック（読み取り専用）
go mod tidy -check

# 整合性修正（go.mod / go.sum を更新）
go mod tidy

3. テスト実行で整合性確認

go test ./... -v

レポートフォーマット

サマリ

チェック結果

パターン1: 整合性が正常

## go.mod / go.sum 整合性チェック結果

✅ 整合性は正常です。

- go mod verify: OK
- go mod tidy -check: OK
- テスト実行: PASS

**対応不要**

パターン2: 整合性を修正

## go.mod / go.sum 整合性チェック結果

⚠️ 不整合を検出し、修正しました。

### 修正前の状態

- go mod verify: ❌ hash mismatch エラー
- 不整合パッケージ: github.com/example/package (v1.2.3)

### 実行したコマンド

```bash
go mod tidy

修正後の確認

• go mod verify: ✅ OK
• go mod tidy -check: ✅ OK
• テスト実行: ✅ PASS

修正完了。以下を実行してください:

git add go.mod go.sum
git commit -m "chore: sync Go dependencies"

#### パターン3: エラー発生（手動対応が必要）

go.mod / go.sum 整合性チェック結果

❌ エラーが発生しました。手動対応が必要です。

エラー内容

hash mismatch in go.sum:
github.com/example/package v1.2.3 h1:XXXXXXXXXXX
wants: h1:YYYYYYY

推奨対応

1. 不整合パッケージをリストアップ
2. 明示的にリクエスト: go get github.com/example/package@latest
3. 再度 go mod tidy を実行
4. テストが通ることを確認

## 詳細な検査フロー

### 1. go.mod のバージョン確認

```bash
grep "^require (" -A 50 go.mod | grep "github.com/example"

2. go.sum の整合性検証

go mod verify

3. 不要な依存の検出

go mod graph | grep "example"

よくある不整合パターン

トラブルシューティング

ネットワークエラーが出た場合

# GoのModuleキャッシュをクリア
go clean -modcache

# 再度実行
go mod tidy

特定パッケージの問題が解決しない場合

# 該当パッケージを明示的に更新
go get -u github.com/example/package@latest

# 整合性確認
go mod verify

注意事項

• go mod tidy は不要な依存を削除するため、必要なパッケージが削除される場合がある
  • 削除前に git diff で確認すること
• CI環境では実行前にキャッシュをクリアすることを推奨
• Goのバージョンによって動作が異なる場合がある（1.16以降推奨）

Converted and distributed by TomeVault — claim your Tome and manage your conversions.