52 lines
2.3 KiB
Markdown
52 lines
2.3 KiB
Markdown
# メモリ機構: memory / Knowledge 検索ツール
|
||
|
||
## 背景
|
||
|
||
`docs/plan/memory.md` §retrieval 経路 で定義した 2 本の検索ツールを Pod から呼べる LLM ツールとして実装する。memory 検索と Knowledge 検索は対象ディレクトリが違うだけで同型の仕様。grep ベースで始め、FTS / vector は将来検討。
|
||
|
||
このツールは Phase 2 Pod の agentic 探索経路としても、通常 Pod の `#<slug>` 展開経路としても、使用頻度メトリクスの観測点としても使う（メトリクスの hook 挿入は本チケットの範囲外、経路だけ揃える）。
|
||
|
||
## 要件
|
||
|
||
### ツール仕様（両者共通）
|
||
|
||
- Input:
|
||
- `query: string`（自由文字列、必須）
|
||
- `slug: string`（完全一致 1 件返し、`#<slug>` 解決に使う）
|
||
- `kind: string`（Knowledge のみ、filter）
|
||
- Output: `{ slug, kind, description, model_invokation, excerpt }` の配列
|
||
- `excerpt` はマッチ箇所の前後数行
|
||
- ソート: grep 出現順（初期）
|
||
- ヒット件数上限と excerpt 行数は設定ファイルで tune
|
||
- 対象ファイルは都度スキャン。派生 index は持たない
|
||
|
||
### 対象
|
||
|
||
- memory 検索: `memory/{summary,decisions,requests}/*.md`（workflow / \_staging は除外）
|
||
- Knowledge 検索: `knowledge/*.md`
|
||
|
||
### 登録
|
||
|
||
- 通常 Pod と Phase 2 Pod の両方に渡せる tool 定義
|
||
- Phase 2 Pod には Knowledge 検索を必ず渡す（全 Knowledge 本文を prompt に埋めない前提）
|
||
|
||
## 範囲外
|
||
|
||
- 使用頻度メトリクス本体（hook 点の予約のみ。カウント・レポートは別チケット）
|
||
- slug サジェスト補完 UI（TUI 側、別途）
|
||
- FTS / vector index
|
||
- 常駐注入（別チケット）
|
||
|
||
## 完了条件
|
||
|
||
- 通常 Pod / Phase 2 Pod 双方から両ツールが呼べる
|
||
- `slug` 指定で完全一致の 1 件が返り、`#<slug>` の本文展開経路として成立する
|
||
- `query` 指定で frontmatter 含む全文から excerpt 付きでヒットが返る
|
||
- Knowledge 検索の `kind` filter が効く
|
||
- 対象外ディレクトリ（`memory/workflow/`, `memory/_staging/`）はヒットしない
|
||
|
||
## 参照
|
||
|
||
- `docs/plan/memory.md` §retrieval 経路 / §Knowledge の採択基準
|
||
- `tickets/memory-file-format.md`（依存: frontmatter スキーマ）
|