85 lines
4.2 KiB
Markdown
85 lines
4.2 KiB
Markdown
# メモリ機構: memory / Knowledge 検索ツール
|
||
|
||
## 背景
|
||
|
||
`docs/plan/memory.md` §retrieval 経路 の 2 本の検索ツールを Pod から呼べる LLM ツールとして実装する。memory 検索と Knowledge 検索は対象ディレクトリが違うだけ。grep ベースで始め、FTS / vector は将来検討。
|
||
|
||
このツールは Phase 2 Pod の agentic 探索経路としても、通常 Pod の `#<slug>` 展開経路としても、使用頻度メトリクスの観測点としても使う（メトリクスの hook 挿入は本チケットの範囲外、経路だけ揃える）。
|
||
|
||
slug 完全一致 1 件返しは検索ツールではなく `MemoryRead`（kind+slug 入力）が担当する。検索 → slug 入手 → Read で本文展開、という二段経路に整理する。
|
||
|
||
## 要件
|
||
|
||
### ツール構成
|
||
|
||
- **MemorySearch**: memory 配下の検索専用 Tool
|
||
- **KnowledgeSearch**: knowledge 配下の検索専用 Tool
|
||
- 単一ファイル取得（slug 完全一致）は `MemoryRead`（既存、本チケットで `kind+slug` 入力に切り替え）
|
||
|
||
### `MemoryRead` の入力変更（memory-file-format からの補正）
|
||
|
||
- 旧: `file_path`（絶対パス）
|
||
- 新: `kind: summary | decision | request | knowledge` + `slug`（summary は slug なし）
|
||
- 同じ補正を `MemoryWrite` / `MemoryEdit` にも適用し、Search 出力をそのまま投げ込める一貫した経路にする
|
||
|
||
### MemorySearch ツール仕様
|
||
|
||
- Input:
|
||
- `query: string`（自由文字列、必須、case-insensitive 部分一致）
|
||
- Output: `{ slug, kind, excerpt }[]`
|
||
- `kind` は record kind（`summary` / `decision` / `request`）
|
||
- summary は slug を `"summary"` 固定で返す
|
||
- `excerpt` はマッチ行の前後 N 行
|
||
- 対象: `memory/summary.md`, `memory/decisions/*.md`, `memory/requests/*.md`
|
||
- 除外: `memory/workflow/`, `memory/_staging/`（読みもしない）
|
||
|
||
### KnowledgeSearch ツール仕様
|
||
|
||
- Input:
|
||
- `query: string`（必須）
|
||
- `kind: string`（任意、KnowledgeFrontmatter の `kind` フィールドで filter）
|
||
- Output: `{ slug, kind, description, model_invokation, excerpt }[]`
|
||
- `kind` / `description` / `model_invokation` は frontmatter から
|
||
- frontmatter parse 失敗時は `null`（本文 grep は機能継続）
|
||
- 対象: `knowledge/*.md`
|
||
|
||
### 共通
|
||
|
||
- ソート: ファイル名昇順 → ファイル内行順（grep 出現順）
|
||
- ヒット件数上限と excerpt 行数は manifest `[memory]` で tune（`search_hit_limit` / `search_excerpt_lines`、デフォルト 20 / 前後 3 行）
|
||
- 対象ファイルは都度スキャン、派生 index は持たない
|
||
- frontmatter も検索対象に含める
|
||
|
||
### 登録
|
||
|
||
- 通常 Pod と Phase 2 Pod の両方に渡せる tool 定義
|
||
- Phase 2 Pod には Knowledge 検索を必ず渡す（全 Knowledge 本文を prompt に埋めない前提）
|
||
- 本チケットでは通常 Pod の controller への登録まで実装。Phase 2 Pod 側の配布は別チケット
|
||
|
||
## 範囲外
|
||
|
||
- 使用頻度メトリクス本体（hook 点の予約のみ。カウント・レポートは別チケット）
|
||
- slug サジェスト補完 UI（TUI 側、別途）
|
||
- FTS / vector index
|
||
- 常駐注入（別チケット）
|
||
- Phase 2 Pod 側のツール配布（Phase 2 チケットの責務）
|
||
|
||
## 完了条件
|
||
|
||
- 通常 Pod から MemorySearch / KnowledgeSearch / MemoryRead / MemoryWrite / MemoryEdit すべて呼べる
|
||
- Search が返す `slug` + `kind` をそのまま `MemoryRead` に渡して本文取得が成立する（`#<slug>` 展開経路）
|
||
- `query` 指定で frontmatter 含む全文から excerpt 付きでヒットが返る
|
||
- KnowledgeSearch の `kind` filter（frontmatter.kind 完全一致）が効く
|
||
- 対象外ディレクトリ（`memory/workflow/`, `memory/_staging/`）はヒットしない
|
||
- `search_hit_limit` / `search_excerpt_lines` の tuning が効く
|
||
|
||
## 参照
|
||
|
||
- `docs/plan/memory.md` §retrieval 経路 / §Knowledge の採択基準
|
||
- `tickets/memory-file-format.md`（依存: frontmatter スキーマ、本チケットで Read/Write/Edit 入力 schema を補正）
|
||
|
||
## Review
|
||
- 状態: Approve
|
||
- レビュー詳細: [./memory-search-tools.review.md](./memory-search-tools.review.md)
|
||
- 日付: 2026-04-27
|