本文へ移動
cccskills
無料GitHub で公開

dev:git-reflect

Git履歴から作業セッションを自動検出し、ブロック単位で振り返りサマリーを生成する。 日付境界でなく、コミット間隔の空白(ギャップ)から自然な作業ブロックを識別する。 「振り返り」「作業履歴」「/dev:git-reflect」で起動。 Trigger: 振り返り, 作業振り返り, git-reflect, git振り返り, /dev:git-reflect, 最近何やった

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.2 KB
  • agents/block-analyzer.md3.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Git 作業振り返り(dev:git-reflect)

概要

Git コミット履歴を時系列で取得し、コミット間のタイムギャップからセッション境界を自動検出。 各ブロックの詳細分析を block-analyzer エージェントに並列委譲(中程度の軽量モデル推奨)し、 結果を統合して振り返りサマリーを表示する。

引数

引数デフォルト説明
ブロック数3振り返るブロック数。ユーザーが「5ブロック」等と指定した場合はそれに従う
ギャップ閾値3時間この時間以上コミット間隔が空いたらブロック境界とみなす

ユーザーが「今日の」「先週の」など期間を指定した場合は --since / --until で絞る。


実行手順

Step 1: コミットログ取得

git log --format="%h %aI %s" -100
  • 直近100件を取得(ブロック数に応じて足りなければ追加取得)
  • %aI で ISO 8601 タイムスタンプを使用(タイムゾーン込み)

Step 2: ブロック分割

コミットを時系列順(古い順)に並べ、隣接コミット間の時間差を計算する。

分割ルール:

  1. ギャップが 3時間以上 → ブロック境界
  2. 日付が変わっても深夜〜早朝の連続作業(例: 23:00→01:00)はギャップが3時間未満なら同一ブロック
  3. 必要なブロック数が揃うまで、新しい方から数える

分割結果として、各ブロックについて以下を確定する:

  • コミットハッシュのリスト(古い順)
  • 時間範囲("MM/DD HH:MM〜HH:MM")
  • 所要時間("約X時間")

Step 3: コミットメッセージからブロックごとの概要を把握

Step 1 で取得済みのコミットメッセージ(%h %aI %s)を各ブロックに振り分け、 メインスレッドでブロックごとのテーマ・作業の流れをざっくり把握しておく。

この時点での理解は「コミットメッセージから読み取れる範囲」に留める。

Step 4: block-analyzer エージェントを並列起動

各ブロックごとにサブエージェントとして block-analyzer(agents/block-analyzer.md)を起動する。 全ブロックを1つのメッセージで同時に起動すること(並列実行)。 軽量〜中程度のモデルで十分。

各エージェントへのプロンプトに含める情報:

  • block_number
  • commits(ハッシュリスト)
  • time_range
  • duration
  • 「agents/block-analyzer.md の手順に従って分析し、diff --stat やファイル変更の詳細を報告せよ」

エージェントの役割は 変更ファイル・行数・ディレクトリ分布など、コミットメッセージだけでは見えない詳細情報の収集・整理。

Step 5: メインスレッドでマージ・出力

Step 3 のコミットメッセージベースの概要と、Step 4 のエージェント報告をマージしてサマリーを生成する。

マージの方針:

  • コミットメッセージから読み取れるテーマ・流れをベースにする
  • エージェント報告の diff 統計・ファイル分布で裏付け・補足・修正する
    • メッセージからは見えなかったテーマの発見(例: メッセージは "fix" だが実際は大規模リファクタ)
    • 変更の重さの定量情報(+X -Y, Nファイル)
    • ディレクトリ分布からのテーマ分割の精緻化
  • 最終出力は ブロック番号順(新しい順: Block 1 が最新) に並べる

3ブロック以上の場合、最後に全体の流れを一言で補足する。


出力例

## Block 1: 3/23 11:19〜15:30 (約4時間) — キーカード LLM 選出

**キーカード選出の大改修**
- finetuning CSV データ整備(140例→100例に精査)
- `select-keycard.ts` をCLI→関数化→Haiku API実装まで段階的に進化
- Z.AI プロキシの Structured Output 問題を修正
- 仕様書 Gate A〜F 全完了

**SKILL.md 改善**
- Predict/Scenario/Learn 分析結果マージ、Thinking phase追加

**コミット数:** 25件 | **変更:** +1200 -300 (42ファイル)

エージェント構成

エージェント推奨モデル役割
block-analyzer軽量〜中程度diff --stat・ファイル分布・変更規模を調査し詳細レポートを返す(サマリー生成はしない)

注意事項

  • 作業内容の良し悪しを評価しない(純粋な振り返り)
  • ユーザーが「何してたっけ」と聞いている前提で、思い出しやすい粒度にする
  • メモリに保存すべき情報があれば提案するが、自動保存はしない

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

日本語の概要は準備中です。原文の説明を表示しています。

ryryo/dot-claude-dev32026年10月10日 更新

analyze-seminar-video

無料日本語概要

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

ryryo/dot-claude-dev32026年10月10日 更新

architecture-refactor-loop

無料日本語概要

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

ryryo/dot-claude-dev32026年10月10日 更新

astra-rules-refactor

無料日本語概要

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

ryryo/dot-claude-dev32026年10月10日 更新

character-sheet-imagegen

無料日本語概要

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

ryryo/dot-claude-dev32026年10月10日 更新

character-to-codex-pet

無料日本語概要

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

ryryo/dot-claude-dev32026年10月10日 更新

ryryo のスキルをすべて見る

このスキルの問題を報告する