Context Optimization Skill
このスキルは、AI エージェントがタスクの方向性を見失ったり、ハルシネーション(嘘の生成)を起こしそうになったり、あるいは単に長時間のセッションでコンテキストをリフレッシュしたい時に使用します。
プロジェクトの「正解(Single Source of Truth)」である docs/ ディレクトリに立ち返り、コンテキストを最適化します。
トリガー
ユーザーが以下のようなリクエストをした場合に、このスキルを参照・実行してください:
- 「コンテキストを整理して」
- 「記憶をリフレッシュして」
- 「状況を再確認して」
- 「ハルシネーションチェックして」
- 「タスクの整理をして」
- 「MCPサーバーを再起動して/読み込んで」
- 「トークンを同期して」
手順 1: Context Refresh (記憶の再同期)
AI のコンテキストウィンドウを「正解」で満たし、古いあるいは不正確な情報を押し出します。
- 憲法の確認:
GEMINI.mdとdocs/TEST_DRIVEN_DEVELOPMENT_POLICY.mdを読み込みます。これは判断の絶対基準です。 - MCP連携の同期:
node scripts/sync-mcp-tokens.jsを実行し、環境変数とツール設定を再同期します。 - 記憶の読み込み:
mcp-memory-serviceを使用して、過去の関連コンテキストを取得します。 - 現状の把握:
docs/TASKS.mdを読み込み、現在進行中のタスク番号とステータスを特定します。 - 経緯の確認:
docs/PROGRESS.mdの最新のエントリを確認し、直近で何が行われたかを確認します。
手順 2: Memory Cleanup (メモリの適正化)
完了した情報が「未完了」として認識され続けないようにクリーンアップします。
- タスク整合性:
TASKS.mdで完了(✅)となっているタスクについて、未だに「やるべきこと」として認識していないか自問自答します。 - ブランチ確認:
git branchを実行し、マージ済みなのに残っているfeature/ブランチがあれば、削除を提案します。 - 一時ファイル確認:
lsやfindでルートディレクトリを確認し、不要な一時ファイル(ログ、スクリーンショットなど)があれば削除を提案します。
手順 3: Hallucination Check (事実確認)
エージェントが前提としている仕様が正しいか検証します。
- アーキテクチャ照合: もし特定の実装方針について迷いがある場合は、
docs/ARCHITECTURE.mdを読み込み、現在の方針がドキュメントと矛盾していないか確認します。 - 矛盾の報告: もし実装とドキュメントに乖離がある場合(実装が進んでドキュメントが古い場合など)、ユーザーに
docs/の更新を提案します。
実行推奨コマンド例
スキル発動時にエージェントが自律的に実行すべきコマンドの例:
# 1. 必読ドキュメントの再読み込み(view_fileを使用)
view_file docs/GEMINI.md
view_file docs/TASKS.md
view_file docs/PROGRESS.md
# 2. ブランチのクリーンアップ確認
git branch --merged
# 3. 現状の差分確認(意図しない変更がないか)
git status
Converted and distributed by TomeVault — claim your Tome and manage your conversions.