オペレーション — Ingest(取り込みと統合)
オペレーション — Ingest(取り込みと統合)
LLM Wiki の Ingest に相当します。Raw sources(一次資料)を読み込み、重要情報を抽出して 既存 Wiki に統合 する工程です。検索対象に追加するだけではありません。
Ingest の原則
| 原則 |
内容 |
| 統合 |
新資料 1 件が 10〜15 ページ に影響しうる — 既存ページへの追記・更新も検討 |
| 重複回避 |
同テーマがあれば新規より 追記・更新 が望ましい |
| index 更新 |
新ページ作成後は No.0 目次 に追加する |
| log 相当 |
MCP 書込時は intent(変更意図)を必ず付ける |
全体の流れ
| 段階 |
やること |
完了の目安 |
| 1. ヒアリング |
目的・読者・Raw sources の確認 |
素材とゴールが明確 |
| 2. 重複確認 |
同テーマの既存ページを探す |
新規 / 追記 / 更新 が決まる |
| 3. 構成案 |
タイトル・No・タグ・見出し一覧 |
ユーザーが構成に同意 |
| 4. 統合執筆 |
本文を書き、既存 Wiki に統合 |
各見出しに中身がある |
| 5. index 更新 |
目次・関連リンクを整備 |
Lint 準備完了 |
Raw sources の取り込み手段
| 手段 |
向いているケース |
| 画面エディター |
ゼロから丁寧に書く・画像を入れる |
| インポート |
Markdown / GitHub / Qiita / Web URL がある |
| MCP(Cursor 等) |
IDE 内でコードを見ながら統合・一括作成 |
重複確認の判断
| 状況 |
推奨アクション |
| 同テーマのページあり |
そのページへ追記・更新 |
| 一部だけ重複 |
既存へ追記、差分のみ新規 |
| 類似だが読者が違う |
別ページ+関連リンク |
| なし |
新規作成 |
統合執筆のポイント
- Raw sources の情報を そのまま貼る のではなく、The Wiki の形式に 編集して統合 する
- 出典がある場合は本文冒頭にリンクを残す(例: Qiita 記事)
- MCP で
create-knowledge するときは intent 必須
- 複数ページに影響するときは
update-knowledge / append-knowledge も併用
対話例
ユーザー: Qiita の LLM Wiki 記事をナレッジに追加したい
アイノウ:
- 既存に LLM Wiki 関連ページはあるか確認
- 基本思想(No.10.1)への統合 or 独立ページか判断
- 構成案を提示 → 執筆 → 目次(No.0)と関連リンクを更新
- Lint(No.13.3)で健診を促す
次のステップ
- 検索精度の設計 → No.13.2 Query
- 品質維持 → No.13.3 Lint