メモリ - 読み取りとアクセス操作

検索、読み込み、同期、履歴、可視化のサブコマンドを備えた統一されたメモリの読み取り側スキルです。

クロスセッション読み取り戦略 (Opus 4.7 / CC 2.1.111+): Opus 4.7 は 4.6 よりもファイルシステムメモリを確実に読み取ります。セッション開始時にコンテキストを読み込む場合は、以下の階層化された読み取り順序を優先してください:

1. ~/.claude/projects/<slug>/memory/MEMORY.md (永続的なインデックス — 最初に読み込み、常に実行)
2. .claude/chain/state.json + 最新の NN-*.json ハンドオフ (セッション継続)
3. ファイルシステムインデックスが回答しない場合は MCP mcp__memory__search_nodes を使用 (型付きグラフトラバーサル)

レイヤー 1 はコスト効率的 (小さいインデックスファイル)、レイヤー 2 はスコープ付き (セッション固有)、レイヤー 3 は選別済み (必要な場合のみ)。完全な知識グラフをコンテキストにダンプしないでください。インデックスを使用して最初に検索を絞り込んでください。

引数の解決

SUBCOMMAND = "$ARGUMENTS[0]"  # 最初のトークン: search, load, history, viz, status
QUERY = "$ARGUMENTS[1]"       # 2番目以降のトークン: 検索クエリまたはフラグ
# $ARGUMENTS は完全な文字列 (CC 2.1.59 インデックスアクセス)

使用方法

/ork:memory search <query>  # 知識グラフを検索
/ork:memory load             # セッション開始時にコンテキストを読み込み
/ork:memory history          # 意思決定タイムラインを表示
/ork:memory viz              # 知識グラフを可視化
/ork:memory status           # メモリシステムのヘルスチェックを表示

---

重要: サブコマンドなしで呼び出された場合は AskUserQuestion を使用

サブコマンドなしで呼び出された場合、ユーザーに何が必要かを尋ねてください:

AskUserQuestion(
  questions=[{
    "question": "どのメモリ操作が必要ですか?",
    "header": "操作",
    "options": [
      {"label": "search", "description": "知識グラフで意思決定とパターンを検索", "markdown": "```\n知識グラフを検索\n──────────────────────\n  query ──▶ mcp__memory ──▶ results\n\n  フラグ:\n  --category  型でフィルタリング\n  --agent     エージェントでスコープ\n  --limit N   最大結果数\n  --global    プロジェクト間\n```"},
      {"label": "load", "description": "このセッション用の関連コンテキストを読み込み", "markdown": "```\nセッションコンテキストを読み込み\n────────────────────\n  プロジェクトを自動検出 ──▶\n  ┌────────────────────┐\n  │ 最近の意思決定      │\n  │ アクティブなパターン │\n  │ プロジェクトエンティティ│\n  └────────────────────┘\n  フラグ: --project, --global\n```"},
      {"label": "history", "description": "意思決定タイムラインを表示", "markdown": "```\n意思決定タイムライン\n─────────────────\n  ┌──── 2月28日 ────────────┐\n  │ Postgres を Mongo より選択 │\n  ├──── 2月27日 ────────────┤\n  │ MVC パターンを採用       │\n  ├──── 2月26日 ────────────┤\n  │ JWT をセッションより選択 │\n  └────────────────────────┘\n  フラグ: --since, --mermaid\n```"},
      {"label": "viz", "description": "知識グラフを Mermaid として可視化", "markdown": "```\n知識グラフの可視化\n───────────────────\n  エンティティ ──▶ Mermaid 図\n\n  [Project] ──uses──▶ [Postgres]\n      │                    │\n      └──has──▶ [Auth] ──uses──▶ [JWT]\n\n  出力: Mermaid コードブロック\n```"},
      {"label": "status", "description": "メモリシステムのヘルスチェック", "markdown": "```\nメモリヘルスチェック\n───────────────────\n  ┌─────────────────────┐\n  │ MCP サーバー  ✓/✗   │\n  │ エンティティ数  N     │\n  │ リレーション数  N    │\n  │ 最後の書き込み 日付  │\n  │ グラフサイズ    N KB  │\n  └─────────────────────┘\n```"}
    ],
    "multiSelect": false
  }]
)

---

サブコマンド

詳細の読み込み: Read("${CLAUDE_SKILL_DIR}/references/memory-commands.md") で、各サブコマンドの完全な使用方法、フラグ、出力形式、およびコンテキスト対応の結果制限を確認してください。

サブコマンド	目的
search	過去の意思決定、パターン、エンティティを検索。--category (metadata.category にマップ)、--limit、--agent (agent_id でスコープ)、--global フィルタフラグをサポート
load	セッション開始時に関連するメモリを自動読み込み。--project、--global をサポート
history	テーブル、Mermaid、または JSON 出力を備えた意思決定タイムライン。--since、--mermaid をサポート
viz	知識グラフを Mermaid 図として描画。Read("${CLAUDE_SKILL_DIR}/references/mermaid-patterns.md") も参照
status	メモリシステムのヘルスチェック

---

ワークフロー

1. サブコマンドを解析

最初の引数をサブコマンドとして抽出
サブコマンドがない場合 -> AskUserQuestion を実行
サブコマンドが以下のいずれかであることを検証: search, load, history, viz, status
残りのフラグを解析
--agent <agent-id> フラグを確認 → agent_id: "ork:{agent-id}"

2. サブコマンドを実行

サブコマンドに基づいて適切なハンドラーにルーティング。

3. 結果を報告

操作に適した形式で出力をフォーマット。

---

ルールクイックリファレンス

ルール	インパクト	対象範囲
entity-extraction-patterns (${CLAUDE_SKILL_DIR}/rules/entity-extraction-patterns.md を読み込み)	高	エンティティ型、リレーション型、グラフクエリセマンティクス
deduplication-strategy (${CLAUDE_SKILL_DIR}/rules/deduplication-strategy.md を読み込み)	高	Edit-over-Write パターン、アンカーベースの挿入、検証

---

セッションの再開

詳細の読み込み: Read("${CLAUDE_SKILL_DIR}/references/session-resume-patterns.md") で、CC 2.1.31 再開ヒント、終了前のコンテキストキャプチャ、および PR、問題、実装のための再開ワークフローを確認してください。

---

関連スキル

• ork:remember - 意思決定とパターンを保存 (書き込み側)

---

エラーハンドリング

• グラフが viz で空の場合: /ork:remember の使用に関するヘルプメッセージを表示
• サブコマンドが無効な場合: 使用方法ヘルプを表示
• メモリファイルが破損している場合: 報告して修復を提案
• 検索クエリが空の場合: 代わりに最近のエンティティを表示
• 検索結果がない場合: 代替案を提案