Git履歴分析
ドキュメント中級
コミット履歴、ブランチパターン、ファイル変更頻度を分析し、プロジェクトのホットスポット、コントリビューターパターン、技術的負債の場所などを視覚的に表示します。
トリガー
/history使用頻度月1回
テックマネージャーなら？ /historyでチームのコード貢献パターンとホットスポットを把握
レガシープロジェクトにアサインされた開発者なら？ 最も頻繁に変更されるファイル = リファクタリング優先順位
Git履歴分析技術的負債
動作フロー
/history 実行 → コミットログ収集
↓
フェーズ1: 3つの分析を並列実行
hotspot-find
変更ホットスポットの検出
contrib-map
コントリビューターパターン分析
churn-calc
コード離脱率の計算
↓
インサイト統合
↓
✓ ホットスポットマップ + 貢献統計 + 技術的負債の場所
スキルコード
# Git Historian Skill
## Trigger: /history [time range]
When invoked:
1. Collect git data:
- `git log --stat` for change frequency
- `git shortlog -sn` for contributor stats
- `git log --diff-filter=M` for modification patterns
2. Analyze patterns:
- Files changed most often (hotspots)
- Code churn (added then quickly deleted)
- Coupling (files that always change together)
- Contributor distribution per directory
3. Output format:
---
## 📜 Git History Analysis
### Change Hotspots (most modified files)
| File | Changes | Last Modified | Risk |
|------|---------|--------------|------|
| [file] | [N times] | [date] | 🔴 |
### Code Churn (high add/delete ratio)
| File | Added | Deleted | Churn Rate |
|------|-------|---------|-----------|
### Coupled Files (always change together)
- [file A] ↔ [file B] (X% co-change rate)
### Contributor Map
| Directory | Primary | Reviewers |
|-----------|---------|-----------|
### Insights
- [hotspot that needs refactoring]
- [area with single point of failure]
---
コピーしてCLAUDE.mdに貼り付ければ、すぐに使えます。
Git履歴分析 の仕組み
Git Historianはリポジトリのコミット履歴を分析し、最も頻繁に変更されるファイル、コントリビューション頻度、技術的負債のホットスポット、開発速度などのパターンを抽出し、構造化レポートとして提示します。
Git履歴分析 が力を発揮する場面
スプリントレトロスペクティブや新しいコードベースへのオンボーディング時に有効です。コードのどの部分が最も頻繁に変更されるか（リファクタリング候補）を明らかにし、プロジェクトがどのように進化してきたかを示します。
主な強み
- 変更頻度から技術的負債のホットスポットを特定
- チームメンバー全体のコントリビューションパターンを可視化
- 開発速度のトレンドを時系列で表示
- データ駆動のインサイトでリファクタリングの優先順位付けを支援