The Schema — 本ガイドの役割
The Schema — 本ガイドの役割
LLM Wiki の 第3層 The Schema に相当します。Wiki の構造・規約・ワークフロー（Ingest / Query / Lint）を定義する「ルールブック」が、この ナレッジ育成ガイド（No.10〜14） 自身です。
Schema としての役割
| 項目 | 内容 |
|---|---|
| 規約 | 1 テーマ 1 ページ、見出し設計、タグと関連リンクの使い分け |
| ワークフロー | Ingest → Query → Lint の 3 操作サイクル |
| 2つの軸 | 育てる（Ingest / Query）と 腐らせない（Lint） |
| 対象 | いま書こうとしている 1 本のナレッジ（製品全体の FAQ ではない） |
向いている相談
| 相談例 | 本ガイドが案内すること |
|---|---|
| 「退会手順をナレッジ化したい」 | Ingest: テーマ分割・構成案・統合方針 |
| 「追記か新規か」 | Ingest: 重複確認と判断基準 |
| 「検索に引っかからない」 | Query: 見出し・タグの改善 |
| 「健診コメントが付いた」 | Lint: 修正箇所の特定と対応 |
対話の進め方（3操作サイクル）
flowchart TD
A[目的・読者の確認] --> B[Ingest: 既存ナレッジの確認]
B --> C{新規 or 統合?}
C -->|新規| D[構成案の提示]
C -->|統合| E[追記・更新箇所の特定]
D --> F[執筆・統合]
E --> F
F --> G[Query: 検索精度の確認]
G --> H[Lint: リンク・健診の促し]
伝えるとスムーズな情報
- 誰向けか（利用者 / オーナー / 開発者）
- 素材の種類（手順・概念・FAQ・表データ）
- Raw sources（社内資料、Qiita、メモ、URL）
- 手段（画面エディター / インポート / MCP）
育成ガイドと操作マニュアルの違い
iknow Navigator は大きく2つのトピックを持ちます。本ガイド（ナレッジの育成方法）と、操作マニュアルの役割分担は次のとおりです。
| ナレッジの育成方法（No.10〜14） | 操作マニュアル（No.1〜8） | |
|---|---|---|
| レイヤー | The Schema + Wiki 設計支援 | iknow.dev の機能・画面のナビゲーション |
| 典型質問 | 「このテーマは 1 本？分割？」 | 「MCP の接続方法は？」 |
| 思想 | LLM Wiki — 育つナレッジベース | iknow.dev 全機能の案内 |
基本思想は No.10.1〜10.2、ページ設計は No.12.x、各操作の詳細は No.13.x、具体例は No.14.1 を参照してください。