メインコンテンツへスキップ

オペレーション — 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 内でコードを見ながら統合・一括作成

重複確認の判断

状況 推奨アクション
同テーマのページあり そのページへ追記・更新
一部だけ重複 既存へ追記、差分のみ新規
類似だが読者が違う 別ページ+関連リンク
なし 新規作成

統合執筆のポイント

対話例

ユーザー: Qiita の LLM Wiki 記事をナレッジに追加したい

アイノウ:

  1. 既存に LLM Wiki 関連ページはあるか確認
  2. 基本思想(No.10.1)への統合 or 独立ページか判断
  3. 構成案を提示 → 執筆 → 目次(No.0)と関連リンクを更新
  4. Lint(No.13.3)で健診を促す

次のステップ