GitHub Copilot の /chronicle で、AIとの対話を「積み上がるナレッジ」に変える📖 | ブログ

GitHub Copilot に搭載された /chronicle コマンドを使うと、過去のセッション履歴を振り返り・改善・コスト最適化に活かせます。使い捨てになりがちな AI エージェントとの対話を「積み上がるナレッジ」に変えるための各サブコマンドを、具体例つきで紹介します。

こんな課題、感じていませんか？

AI エージェントを使った開発では、次のような場面に心当たりがあるのではないでしょうか。

前回どのような指示をしたか、セッションの内容を思い出せない
AI エージェントに同じ間違いを繰り返し指摘している
トークンやコストが、気づかないうちに膨らんでいる

AI エージェントとの開発では、せっかくの対話がその場限りのやり取りで使い捨てになりやすいという問題があります。過去のセッションが資産として活用できていない状態です。

/chronicle は、こうした課題を解消し、対話のログを再利用できるナレッジに変えるための GitHub Copilot のコマンドです。

/chronicle でできること

/chronicle は複数のサブコマンドで構成されていて、大きく次のことができます。

目的	サブコマンド
振り返り	`standup` で前回までの作業状況を要約
自己改善	`tips` / `improve` でプロンプトの癖や摩擦を検出し、指示や規約に反映
コスト管理	`cost tips` でトークンのムダを可視化
再利用	`search` で過去ログを横断検索
メンテナンス	`reindex` で検索精度を復旧

ここからは、それぞれを具体例つきで見ていきます。

使い方 — CLI と VS Code の両方から使える

/chronicle は Copilot CLI 専用ではありません。VS Code の Copilot Chat からも、同じセッション履歴を横断検索・要約できます（試験的機能）。

Copilot CLI: /chronicle と入力するとサブコマンド一覧が表示されます
VS Code: 設定で Local Index を Enabled にすると、セッションデータがローカルで追跡され、/chronicle が使えるようになります

作業状況を振り返る：standup

standup は、触っていたブランチ・達成事項・関連する PR / Issue の状態を自動で整理してくれるサブコマンドです。

Code

/chronicle standup 直近3日分を教えて

既定は直近 24 時間分ですが、上記のように期間は自然文で指定できます。出力は次のようなイメージです。

Code

 Done
 ユーザー認証機能 (`feature-auth` branch)
  - Merged: #123 / Session: 8f2c91a4...
 In Progress
 決済フォームの改善 (`feature-checkout` branch)
  - Draft: #789 / Session: a1b2c3d4...

完了したセッションと進行中のセッションが、ブランチ・PR 番号・セッション ID とともに一覧化されます。作業を再開するときに記憶を辿る時間がゼロになり、AI との続きの会話にすぐ戻れます。

プロンプトの改善点を把握する：tips

tips は、実際のプロンプト・使用ツール・使っていない機能を横断分析し、実データに基づく 3〜5 個の推奨事項を提示してくれます。

Code

/chronicle tips もっと良いプロンプトの書き方を教えて

出力例は次のようなものです。

Code

1. 内容を貼り付けずに @ でファイルを参照する
2. セッション内でイテレートする — 最初からやり直さない
3. 探索作業には /research を試す
4. よく使うプロンプトはカスタムエージェント化する
5. 複数手順の作業には plan モードを使う

「我流のプロンプト」が、AI エージェント本来の機能を活かした指示に変わっていくのがポイントです。指摘対象はあくまで使っているユーザー側が直すべき項目です。

コスト削減のヒントを得る：cost tips

cost tips は、tips のコスト版です。トークン使用量・プロンプトの長さ・ツール呼び出し頻度からムダを検出し、クレジット削減につながる具体策を提示してくれます。

Code

/chronicle cost tips

出力例は次のとおりです。

Code

1. 同じファイルを何度も貼り付けず、@ でファイル参照する
2. 会話を都度リセットせず、セッション内でイテレートする
3. 長いログ出力はコマンド側で絞ってから渡す（--quiet, | head 等）
4. 探索作業は最初から並列 agent に投げず、まず自分で2〜3手試す

「なんとなく高い」を「どこが高いか」に変えられるので、コストを制御下に置けます。

過去の作業を検索する：search

search は、キーワードでセッション履歴全体を横断検索するサブコマンドです。

Code

/chronicle search 認証

意味解釈（セマンティック検索）ではなくキーワードの直接検索なので、狙ったセッション履歴を正確にヒットさせられます。

Code

「認証」の検索結果（2件ヒット）
backend-api リポジトリ
 - リフレッシュトークンのローテーションを実装したい
 - JWT の有効期限は何分に設定するのが妥当か
 - Session: 8f2c91a4-3d7e-4b1a-9c88-2e5f7a1b4c30
→ このセッションを再開するには: copilot --resume 8f2c91a4...

検索対象はプロンプトの内容だけではありません。AI が触ったファイルのパスや PR 番号なども検索でヒットさせられるので、過去の試行錯誤や解決策を毎回ゼロから再発明せずに済みます。

繰り返しの指摘をリポジトリ規約に反映する：improve

improve は、テスト失敗やビルドエラーの繰り返しなどの「摩擦シグナル」を検出し、リポジトリの規約に反映してくれるサブコマンドです。tips がユーザー側への指摘だったのに対し、こちらは Copilot 側が直すべき事項を提案してくれるイメージです。

Code

/chronicle improve

推奨事項ごとに ON / OFF を選べて、承認すると .github/copilot-instructions.md を自動更新してくれます。

Code

1. CLAUDE.md に「テストは jest ではなく vitest を使う」と明記
2. package.json の scripts に "test:watch" を追加（手動実行の指摘が続いたため）
→ 適用する項目を選択... (すべて選択 / 個別に OFF 可)

スコープは今のリポジトリ / 作業ディレクトリのみです。AI がプロジェクトの流儀を学習することで、同じ指摘が減っていきます。

検索精度が落ちたら再構築する：reindex

reindex は、セッションストア（~/.copilot/session-store.db）を再構築するサブコマンドです。他のサブコマンドと比べると使用頻度は落ちますが、次のような場面で効きます。

Code

/chronicle reindex

古いセッションファイルが反映されていない
別マシンへの移行・バックアップ復元をした
ストアファイルの破損・クラッシュ後の欠損

セッションストアは増分更新なので、履歴がぐちゃぐちゃになったときに自分でリカバリできる、という位置づけです。

いつ、どのコマンドを使うか

サブコマンドがたくさん出てきたので、開発フェーズごとの使い分けを整理します。

フェーズ	使うコマンド
作業を始める・前回の続きから再開したい	`standup`
作業中に思い出したい・過去の類似作業を探す	`search`
同じ指摘が増えてきた	`tips` / `improve`
コストが気になる	`cost tips`
検索精度が落ちた・環境移行/復旧時	`reindex`

迷ったら「今どのフェーズか」からコマンドを逆引きできます。

使ってみて気になったポイント

登壇後の質疑でも挙がった、実運用で気になる点を共有します。

セッションの「コンパクト」動作と reindex の関係は未確認 セッションを整理する「コンパクト」動作が走った場合に reindex がどう作用するかは、現時点では明確になっていません。コンパクトは見た目上の要約でセッション履歴自体は残っていると思われますが、両者の干渉については検証が必要です。

improve による自己改善は「個人単位」 improve の自己改善は各ユーザーとの対話に基づくもので、チーム内での共有は想定されていません。そのため、複数のメンバーがそれぞれ improve を実行すると、.github/copilot-instructions.md の設定がユーザー間で衝突する可能性があります。チーム開発で規約を揃えていくには、この点をどう運用するかが今後の課題になりそうです。

他ツールに同等のビルトインはある？ Claude Codeには /chronicle と同等のビルトイン機能は見当たらず、現状ではGitHub Copilot固有の機能でした（これまでの作業要約や過去のセッションを呼び出せる /recap や /resume といった履歴系のコマンドはありますが、/chronicle のようにサブコマンド全体で揃ったものはありませんでした）。 Codexについてはコマンド形式ではないものの、画面の作業コンテキストをバックグラウンドで自動同期する「Chronicle」という標準機能がビルトインされています。

まとめ

/chronicle は、AI エージェントとの対話を「その場限りのやり取り」から「積み上がるナレッジ」に変えるコマンドです。

振り返り（standup）
自己改善（tips / improve）
コスト管理（cost tips）
再利用（search / resume）

これらが一つのコマンド体系に揃ったことで、AI を使った開発そのものが「継続的に賢くなっていく」ようになります。まずは /chronicle standup から試してみてください。

参考リンク：