wiki-config

Wiki Config

wiki-config.md の対話型セットアップ、検証、メンテナンスを行います。同じ設定を読み込む、5 つの運用 Wiki スキル（wiki-ingest、wiki-lint、wiki-integrate、wiki-crystallize、wiki-query）と連携します。

---

機能要件

ファイルシステムの読み取り、書き込み、検索、ディレクトリ作成が必要です。ファイルシステムツールを利用できない環境で実行している場合は、ユーザーに伝えて終了してください。

---

ワークフロー

ステップ 0 - ようこそと初期化

wiki-config が呼び出されるたびに、ここから開始します。

Wiki スキルのエコシステムを表示する

このセッションで利用可能な Wiki スキルを確認します。コンテキスト内の <available_skills> セクションを調べ、wiki-* パターンに一致するスキル（wiki-config、wiki-ingest、wiki-query、wiki-lint、wiki-integrate、wiki-crystallize）を探します。<available_skills> にあるスキルは有効化されており、使用可能です。✓ を付けてください。見つからないスキルは、インストールされていないか、ユーザーの設定でオフになっています。✗ を付けてください。

実際の状況を反映した次の表を表示します。

## Wiki Skill Ecosystem

| Skill | Status | What it does |
|---|---|---|
| wiki-config | ✓ | Interactive setup and validation |
| wiki-ingest | [✓/✗] | Process raw/ → wiki pages → ingested/ |
| wiki-query | [✓/✗] | Search wiki, cite sources, file good answers |
| wiki-lint | [✓/✗] | Health checks: broken links, orphans |
| wiki-integrate | [✓/✗] | Add backlinks when pages change |
| wiki-crystallize | [✓/✗] | Distil conversations into wiki pages |

不足しているスキルがある場合：「エコシステム全体を利用するには、https://github.com/vanillaflava/llm-wiki-skills からインストールしてください。」

同梱の references/setup-help.md は、このセッション中いつでも利用できます。セットアップの詳しい説明が必要なとき、ユーザーから Wiki システムについて詳細な質問があったとき、または行き詰まったときに読み込んでください。

ようこそのメッセージを表示する

「お互いの状況を把握するために、セットアップガイドを読みます……」

次に、以下を表示します。

---

あなたの LLM-Wiki へようこそ

始める前に、簡単にご説明します。

ファイルシステムのアクセス範囲 - ファイルシステムツールがアクセスできるディレクトリです。これが外側の境界になります。ツールのアクセス範囲は必要最小限にしてください。広範囲へのアクセスはプライバシー上のリスクになります。

Wiki ルート - その範囲内にある、Markdown ノートと Wiki システムファイル（wiki-config.md、wiki-help.md、Home.md、Overview.md、index.md、log.md、raw\、ingested\、templates\）を格納するフォルダーです。ここに .md ファイルを保存します。Obsidian Vault や Logseq グラフの一部でも、ノートを管理している場所でもかまいません。各スキルは wiki-config.md を探して Wiki ルートを見つけます。

重要： Wiki ルートを、マシンのルート（C:\、/）やユーザーホームにしないでください。プライバシー上のリスクになります。また、Vault やグラフ全体を指定する必要もありません。

ナレッジベースのサブディレクトリを Wiki ルートに設定し、エージェントとの共有に問題のないフォルダーだけを指定することをおすすめします。

この Wiki は既存のノートと連携し、ソース（PDF、記事、ドキュメント）を相互に関連付けられた Wiki ページへとまとめるのに役立ちます。ソースを追加するたび、質問をするたびにナレッジベースは充実し、時間とともに蓄積されていきます。

---

ユーザーが戸惑っている様子だったり、詳しい説明を求めたりした場合は、「セットアップガイド全体を表示しましょうか？」と提案します。その後、references/setup-help.md を読み込んで表示します。

それ以外の場合は、状態の確認に進みます。

状態の確認と分岐

ファイルシステムのアクセス範囲を確認する：

ファイルシステムのアクセス範囲のルート、つまりファイルシステムツールがアクセスできる最上位のディレクトリを特定します。

アクセス範囲が不適切な場合（ドライブのルート、OS のルート、またはユーザーホーム）：

「ファイルシステムのアクセス範囲が [scope] に設定されています。これは範囲が広すぎるため、プライバシー上のリスクになります。セットアップ後に Wiki フォルダーだけに範囲を絞ることをおすすめします。

Wiki ルートの絶対パスが必要です。例：

• Windows：C:\Users\YourName\Documents\wiki
• Mac：/Users/YourName/Documents/wiki

パスを教えてください。」

プライバシーへの配慮： ユーザーを一覧表示したり、システムフォルダーを列挙したりしないでください。パスを直接尋ねてください。

アクセス範囲が適切な場合： wiki-config.md を再帰的に検索します（最大 5 階層）。

検索結果に応じて分岐する：

→ 設定ファイルが見つからない - 「まだ Wiki がありません。セットアップをご案内します。」→ ステップ 2（初期化）

→ 設定ファイルが見つかった - 読み込んだ後、同じディレクトリで環境全体を確認します。以下の各項目を確認してください。

1. wiki-schema.md - 存在し、正常に解析できる / 見つからない / 形式が不正
2. wiki-help.md - 存在する / 見つからない
3. templates/ フォルダー - 存在する / 見つからない
4. テンプレートファイルの完全性 - 期待される13個のファイルのうち、存在するもの（knowledge.md、reference.md、survey.md、domain-home.md、overview.md、home.md、log.md、index.md、longform.md、profile.md、established-patterns.md、note.md、config.md）
5. wiki-config.md の templates_folder: フィールド - 存在する / ない

簡潔で親しみやすい要約を、コンポーネントごとに1行で表示します。例：

Wiki 環境

• wiki-config.md：見つかりました
• wiki-schema.md：見つかりました
• wiki-help.md：見つかりました
• templates/：存在します（13ファイル中9ファイル）
• templates_folder フィールド：設定にありません

対応が必要な項目が2つあります。まとめて修復することも、個別に選ぶこともできます。

すべて正常な場合： メインメニューを直接表示します。

項目が見つからない、または破損している場合： 上記の要約を表示してから、次の選択肢を提示します。

• 「すべて修復」 - 不足している項目をすべて一度に配置します。開始前に確認を1回求めます
• 個別に選択 - 対応する項目をユーザーが選びます

コンポーネントごとの修復アクション：

• wiki-schema.md が見つからない → assets/wiki-schema.md から配置します（非破壊的で、確認は不要です）
• wiki-schema.md の形式が不正 → 警告し、同梱のデフォルトにリセットする選択肢を提示します。上書き前に確認を求めます
• wiki-help.md が見つからない → assets/wiki-help.md から配置します（非破壊的で、確認は不要です）
• templates/ フォルダーが見つからない → 以下の引用メッセージでテンプレートを紹介してから、フォルダーを作成し、assets/templates/ から13個すべてのファイルとREADMEを配置する選択肢を提示します
• 個別のテンプレートファイルが見つからない → assets/templates/ から不足しているファイルだけを配置します。すでに存在するファイルは上書きしません
• 設定に templates_folder: がない → wiki-config.md に templates_folder: templates/ を書き込みます。templates/ フォルダーの存在を確認できた場合に限り実行します

templates/ が見つからない、または不完全で、ユーザーがこれまでテンプレートについて説明を受けたことがない場合は、次の内容を表示します。

ページテンプレート

テンプレートを使うと、すべての Wiki ページに一貫性のある構成済みのひな形を用意できます。スキルが新しいページを作成する際は、templates/ フォルダーから対応するテンプレートを読み込み、ひな形として使用します。その際、{{TITLE}} や {{DATE}} のようなプレースホルダーを実際の値に置き換えます。

テンプレートは自由に編集できます。変更は新しいページに即座に反映され、既存のページが変更されることはありません。テンプレートファイルが見つからない場合、スキルは最小限のハードコードされた構成にフォールバックします。

デフォルトのセットには、13個すべてのデフォルトテンプレート（12種類のページタイプと、特別なトップレベルの Home ナビゲーションハブ）が含まれます。テンプレートは、knowledge、reference、survey、domain-home、overview、home、log、index、longform、profile、established-patterns、note、config です。

表示後、次のように尋ねます。「デフォルトのテンプレートセットを <wiki_root>/templates/ に配置しますか？」

修復後は、更新されたステータスを表示し、メインメニューを提示します。

メインメニュー（すべてのコンポーネントが正常な場合）：

次の選択肢を提示します。

• 設定を検証（ステップ3）
• 設定を編集（ステップ4）
• スキーマを管理（ステップ5）
• テンプレートを管理（ステップ6）

2 - 初期化

ユーザーに Wiki のルートを尋ねます。

「wiki-config.md を設定しましょう。Wiki のルート（ノートが保存されているフォルダー）の絶対パスを教えてください。

Wiki のルートは、マシンのルート（C:\、/）やユーザーのホームディレクトリ（C:\Users\you\、~/）ではありません。ノートと Wiki システムファイルが保存されている特定のフォルダーです。ファイルシステムツールのスコープ内にある必要があります。

例：C:\Users\you\Notes\、/Users/you/Documents/Wiki/、/home/you/vault/」

返されたパスを検証します。

• ドライブのルートだけのパス（C:\、D:\、/）は拒否します
• OS のルートやユーザーのホームディレクトリ（/home/、/Users/、C:\Users\）は拒否します
• パスが存在し、書き込み可能であることを確認します

チェックに失敗した場合は、どのチェックに失敗したかを説明して、もう一度尋ねます。

基本ファイルを配置します。

1. assets/wiki-config-template.md を <wiki_root>/wiki-config.md にコピーします
2. テンプレートに templates_folder: templates/ がまだ含まれていない場合は、<wiki_root>/wiki-config.md に書き込みます
3. assets/wiki-schema.md を <wiki_root>/wiki-schema.md にコピーします
4. assets/wiki-help.md を <wiki_root>/wiki-help.md にコピーします（存在しない場合のみ。既存のコピーは上書きしません）
5. <wiki_root>/index.md が存在しない場合は、assets/templates/index.md をもとに作成し、{{TITLE}} = "index"、{{DATE}} = 今日の日付、{{DESCRIPTION}} = "すべての Wiki ページのカタログ。" に置き換えます
6. <wiki_root>/log.md が存在しない場合は、assets/templates/log.md をもとに作成し、{{TITLE}} = "log"、{{DATE}} = 今日の日付、{{DESCRIPTION}} = "Wiki スキルのすべての操作を追記のみで記録する監査履歴。" に置き換えます
7. <wiki_root>/Home.md が存在しない場合は、assets/templates/home.md をもとに作成し、{{TITLE}} = "Home"、{{DATE}} = 今日の日付、{{DESCRIPTION}} = "ナビゲーションハブ。スキルのワークフロー、主要ページ、ドメインへのリンク。" に置き換えます
8. <wiki_root>/Overview.md が存在しない場合は、assets/templates/overview.md をもとに作成し、{{TITLE}} = "Overview"、{{DATE}} = 今日の日付、{{DESCRIPTION}} = "すべてのドメインにわたる最新の知識をまとめた、継続的に更新される統合概要。Vault レベルの結晶化対象。" に置き換えます
9. <wiki_root>/raw/（取り込みキュー）を作成します
10. <wiki_root>/ingested/ と、ingested_subdirs にある各サブディレクトリ、および <wiki_root>/ingested/assets/（常に作成）を作成します
11. <wiki_root>/templates/ を作成し、assets/templates/ にある13個のテンプレートファイルをすべてコピーします
12. assets/templates/README.md を <wiki_root>/templates/README.md にコピーします
13. log.md のヘッダー行の下、既存のすべてのエントリの上に、初期化エントリを先頭に追加します

ユーザーに作成したものを報告します。wiki-config.md、wiki-schema.md、wiki-help.md、Home.md、Overview.md、テンプレートフォルダー（テンプレートファイル13個）を明記します。次のステップとして、概要を確認するために Home.md を開くこと、raw/ にファイルを入れて /wiki-ingest を実行し、ナレッジの構築を始めることを提案します。

3 - 検証

設定を読み込み、次の項目を確認します。

• YAML をエラーなく解析できる
• 必須フィールドがすべて存在する：blacklist、index_excludes、ingested_folder、ingested_subdirs、log_format
• blacklist と index_excludes のパスが相対パス文字列である（絶対パスやプロトコルを含まない）
• ingested_folder が index_excludes に含まれ、blacklist には含まれない
• 設定ファイルを含むディレクトリである Wiki のルートが、ステップ2の検証に合格する
• blacklist の値が実在するフォルダー名であり、テンプレートのプレースホルダーではない（同梱テンプレートのプレースホルダーが残っている場合は指摘します）

確認結果を報告します。問題がある場合は、それぞれ修正案を提示し、適用前に確認を求めます。

4 - 再設定

ユーザーが値の変更を希望する場合：

• 現在の値を表示します
• フィールドの役割を説明したうえで、新しい値を尋ねます
• 書き込む前に確認します
• コメントと構造を維持したまま、wiki-config.md に書き戻します

黙って上書きしてはいけません。再設定は常に、明示的な確認を得てから行います。

5 - スキーマ管理

スキーマ管理では、ユーザーが wiki-schema.md を表示、編集、リセット、または修復できます。

何よりも先に、このスキル自身のアセットフォルダーにある assets/wiki-schema.md を読み込んでください。 この同梱ファイルがデフォルトスキーマです。6つすべての Wiki スキルで一貫性を保てる、最低限のフィールドと列挙値を定義しています。リセット／修復操作における「デフォルト」の意味を理解し、安全な編集とリスクのある編集を正確に説明するために、このファイルをコンテキストに含めておく必要があります。

次に、デプロイ済みの <wiki_root>/wiki-schema.md を読み込みます。

比較して、次のように提示します：

デプロイ済みのスキーマが問題なく解析できる場合 → 「現在のスキーマはこちらです：」と伝え、フロントマターの YAML を表示します。次の選択肢を提示します：

• そのまま維持 → メインメニューに戻る
• 同梱のデフォルトにリセット → 明示的な確認を得てから、同梱テンプレートで上書きする
• フィールドまたは列挙値を編集 → 対話形式で変更する（以下を参照）

デプロイ済みのスキーマに不備がある場合（YAML の解析エラー、重要なセクションの欠落） → 「wiki-schema.md に不備があります：[具体的なエラー]。同梱のデフォルトにリセットするか、手動で編集できます。どちらを希望しますか？」と伝えます。

デプロイ済みのスキーマが見つからない場合 → Step 0 の分岐で処理済みのはずなので、ここには到達しないはずです。到達した場合は、確認を得てから同梱テンプレートをデプロイします。

スキーマフィールドの編集：

ユーザーがスキーマの変更を希望した場合は、変更を受け付ける前に次の警告を表示します：

「同梱スキーマは、最低限の一貫性を保てる構成を定義しています。必須フィールドの削除、フィールド名の変更、既存ページで使われている列挙値の削除、フィールド型の変更は、スキルの動作不良（書き込み失敗、無効なページ、リンターの誤検出）を引き起こす可能性があります。新しい条件付きフィールドの追加や、列挙値リストの拡張は、通常、安全です。」

次に、何を変更するかを尋ねます：必須フィールド、条件付きフィールド、または列挙値リスト。

変更ごとに：

• 現在の値を表示する
• 新しい値を受け付ける
• 検証する：mandatory_fields に title、version、date、changes、page_type が引き続き含まれていること
• 検証する：ユーザーが削除を明示的に確認しない限り、3つすべての列挙値に少なくともデフォルト値が含まれていること
• 書き込む前に確認する
• コメントと構造を保持したまま wiki-schema.md に書き戻す

リセット／修復：

ユーザーから依頼があった場合は、assets/wiki-schema.md を <wiki_root>/wiki-schema.md にコピーします。操作を記録します。次のように確認します：「スキーマを同梱のデフォルトにリセットしました。次回の実行から、各スキルでこのスキーマが使われます。」

カスタムスキーマを、ユーザーに知らせずに上書きしてはいけません。リセットは必ず明示的な操作として、確認を得てから実行します。

6 - テンプレート管理

テンプレート管理では、<wiki_root>/templates/ にあるページテンプレートを表示、修復、リセット、または確認できます。

このフローを初めて開始したときに、次の案内を表示します。

ページテンプレート

テンプレートを使うと、すべての Wiki ページに一貫性のある構造化された出発点を用意できます。スキルが新しいページを作成するときは、templates/ フォルダーから対応するテンプレートを読み込み、ひな形として使用します。その際、{{TITLE}} や {{DATE}} などのプレースホルダーを実際の値に置き換えます。

テンプレートは自由に編集できます。変更は新しいページにすぐ反映されますが、既存のページが変更されることはありません。テンプレートファイルがない場合、スキルは最小限のハードコードされた構造にフォールバックします。

デフォルトのセットには、13 個すべてのデフォルトテンプレートが含まれています（12 種類のページタイプと、特別な最上位の Home ナビゲーションハブ）。knowledge、reference、survey、domain-home、overview、home、log、index、longform、profile、established-patterns、note、config です。

現在の状態を確認します：

<wiki_root>/templates/ 内のファイルを一覧表示します。想定される 13 個のファイルのうち、存在するものと不足しているものを特定します。

次のように状態を表示します。

テンプレートフォルダー：[13 個のデフォルトテンプレートのうち X 個が存在]

存在するもの：knowledge.md、survey.md、... [一覧] 不足しているもの：reference.md、... [該当する場合は一覧]

アクションを提示します：

• テンプレートを表示 - 名前を指定したテンプレートファイルの内容を読み込んで表示します。ユーザーはノートアプリで直接編集できることを伝えます
• 不足しているデフォルトを配置 - assets/templates/ から不足しているファイルを <wiki_root>/templates/ にコピーします。すでに存在するファイルは上書きしません
• 特定のテンプレートをリセット - 名前を指定したテンプレートを同梱のデフォルトで上書きします。実行前に警告します
• すべてのテンプレートをリセット - 13 個すべてを同梱のデフォルトで上書きします。実行前に警告します
• README を表示 - <wiki_root>/templates/README.md を表示します

リセット時の注意 - リセットを実行する前に表示します。

「テンプレートをリセットすると、編集内容が同梱のデフォルトに置き換わります。既存の Wiki ページには影響せず、新しい構造が適用されるのは今後作成するページのみです。このスキル内から元に戻すことはできません。」

個別にリセットする場合はファイルごとに確認します。すべてをリセットする場合は、13 個すべてのファイルを一覧表示してから一度確認します。

アクションの後、別のテンプレート操作を続けるか、メインメニューに戻るかを尋ねます。

---

主なルール

1. このスキルがセットアップの UX 全体を担います。 5 つの運用スキルはすべて、設定が見つからない場合は処理を拒否し、ユーザーにここ（またはこのスキルがインストールされていない場合は、手動セットアップ用の同梱ファイル references/setup-help.md）を案内します。ひな形の作成、設定の検証、再設定を行うのはこのスキルだけです。「wiki config をセットアップする」トリガーを提示するのもこのスキルだけです。
2. 明示的な確認なしに、使用中の設定を上書きしてはいけません。 再設定は項目ごとに対話形式で行います。
3. Wiki ルートは wiki-config.md が置かれているディレクトリです。 設定に wiki_root フィールドはありません。Wiki を移動するには、このファイルを移動します。
4. ドライブのルート、OS のルート、またはユーザーのホームディレクトリにデプロイしてはいけません。 こうした場所が指定された場合、ほとんどの場合はユーザーの誤操作です。
5. 同梱アセットを唯一の信頼できる情報源とします。 このスキルには assets/wiki-config-template.md、assets/wiki-schema.md、assets/wiki-help.md、および assets/templates/（テンプレートファイル 13 個と README）が含まれています。初期化時には、これらすべてをデプロイします。5 つの運用スキルには、それぞれの references/ フォルダーに、wiki-config-template.md と wiki-schema.md の同一内容の読み取り専用コピーが含まれています。ここで共有ファイルを変更した場合は、運用スキル側のコピーも必ず同時に更新してください。references/setup-help.md も、運用スキル間で同期した状態に保ってください。
6. wiki-config はセットアップ、編集、修復に推奨される方法です。 ガイド付きのスキーマエディターと修復フローを備えているのは wiki-config だけです。wiki-config を利用できない場合や、ユーザーがそのまま進めることを希望する場合は、運用スキルから references/ フォルダー内の同梱デフォルトをデプロイできます。ただし、利用可能な場合は、まず /wiki-config を推奨してください。不正な形式のスキーマを黙って上書きしてはいけません。この場合は必ず、上書きの警告を表示したうえで、ユーザーに明示的な判断を求めてください。

---

このスキルで行わないこと

• Wiki の操作（取り込み、lint、統合、結晶化、クエリ）は行いません。これらは 5 つの運用スキルが担当します。
• TaskNotes の設定、プラグインの設定、または Wiki 以外の設定は管理しません。
• Wiki ルートの外にはアクセスせず、ファイルシステムツールのスコープも変更しません。
• テンプレートの内容を直接編集しません。テンプレートのデプロイ、修復、リセットは行いますが、編集するのはユーザーのノートアプリです。