wiki-integrate

Wiki Integrate

新規または更新された Wiki ページにバックリンクとインデックスエントリーを追加し、ナレッジグラフに接続します。

---

Config Discovery

すべての実行はここから始まります。 Wiki のルートは、wiki-config.md を含むディレクトリです。スキルは実行時にルートを特定します。このスキルが書き込むページは wiki-schema.md の構造に従います。両方のファイルが必要です。

1. スコープを特定する：ファイルシステムのスコープルート（ファイルシステムツールがアクセスできる最上位のディレクトリ）を特定します。

2. スコープを確認する — 必ず停止：スコープがドライブのルート（C:\、D:\、/）、OS のルート、またはユーザーのホームディレクトリ（C:\Users\X、/home/X、/Users/X）の場合は、直ちに停止してください。検索してはいけません。wiki-config.md を探そうとしてはいけません。 手順 6 に進んでください。

3. <available_skills> で wiki-config を探します。 利用可能かどうかを確認します。以下の推奨事項はこれによって変わります。バンドルされている references/setup-help.md も利用できます。ユーザーが案内を必要としている場合、または行き詰まった場合は、これを読んでください。

4. wiki-config.md を見つけて読み込みます：再帰的に検索します（最初に見つかったものを使用し、最大 5 階層まで）。見つかった場合は読み込みます（blacklist、index_excludes、ingested_folder、ingested_subdirs、log_format）。見つからない場合は、手順 6 に進みます。

5. wiki-schema.md を見つけて読み込む — 必須確認：wiki-config.md と同じディレクトリに wiki-schema.md が存在し、YAML として解析できることを確認します。確実な判定（存在する／不足している／不正な形式）を得るまでは、以下のワークフローに進んではいけません。次に：

   • 存在し、問題なく解析できる → スキーマ（mandatory_fields、conditional_fields、enums）を読み込み、ワークフローに進みます。

   • 不足している → 停止します。先に進んではいけません。デプロイしてはいけません。応答は、手順 3 で確認した <available_skills> に wiki-config が含まれているかどうかによって異なります。

     • wiki-config が利用可能： 次のパターンをそのまま出力します — "Your wiki is missing wiki-schema.md. Run /wiki-config to deploy it and complete setup. I'll wait for that to be done before proceeding." これでターンを終了します。バンドル版のデプロイを提案してはいけません。wiki-config が利用可能な場合は、案内に沿って設定する方法が適切です。

     • wiki-config が利用不可： バンドル版を代替として提示します — "Your wiki is missing wiki-schema.md and the wiki-config skill is not installed. I can deploy a default from my bundled reference, but I'd recommend installing wiki-config for the guided setup. Deploy bundled default?" 明示的な確認を待ちます。了承を得たら、references/wiki-schema.md からデプロイします。

   • 不正な形式 → 停止します。同じ分岐です。

     • wiki-config が利用可能： "wiki-schema.md の形式が不正です。/wiki-config を実行してください。カスタマイズ内容を保持したまま修復するための案内付きフローが用意されています。お待ちしています。" これでターンを終了します。修復を試みたり、バンドル版で上書きしたりしてはいけません。

     • wiki-config が利用不可： 手動で修復する方法について、references/setup-help.md を参照するよう案内します。ユーザーがリセットを明示的に指示した場合（自動的な代替手段としてではなく）は、カスタマイズ内容が上書きされることを警告し、明示的な了承を得てからデフォルトをデプロイします。

   手順 4 で wiki-config.md 自体が不正な形式と判明した場合も、同じ 2 つの分岐を適用します。wiki-config が利用可能な場合は、停止して /wiki-config を推奨し、ターンを終了します。利用不可の場合は、setup-help.md に沿って手動修復を案内します。

6. 設定ファイルが見つからない：ユーザーに Wiki のルートパスを尋ね、その場所を検索します（最大 5 階層まで）。それでも見つからなければ、まだ Wiki がありません。上記の「不足している」分岐に従います（/wiki-config を推奨し、利用不可の場合はバンドル版のデプロイを提示します）。

---

Capability Requirements

このスキルにはファイルシステムの読み取りと書き込みアクセスが必要です。利用できない場合は、その旨をユーザーに伝えて停止してください。

このスキルを使用するタイミング

次の場合に wiki-integrate を実行してください。

• チャット内で新しい Wiki ページが直接作成された場合（wiki-ingest を介していない場合）
• 既存のページが大幅に改訂され、新たな関連付けの機会が生まれている可能性がある場合
• ボルト内に、ナレッジグラフから孤立しているページがある場合

wiki-ingest は未加工のソース資料を Wiki ページに変換し、自動的にリンクします。wiki-integrate は、Wiki コンテンツとしてすでに存在するページをリンクします。一方をもう一方の代わりに使用しないでください。

---

入力

Wiki-integrate は対象ページを処理します。新規作成または更新したページのパスを指定してください。パスが指定されていない場合は、作業を進める前に、統合するページをユーザーに尋ねてください。

---

ワークフロー

Config Discovery によって、wiki-config.md と wiki-schema.md はすでにコンテキストに読み込まれています。再度読み込まず、両方が使用可能な状態としてここから進めてください。

ステップ 1 - 対象ページを読む

対象ページの全内容を読みます。主なトピック、重要な概念、既存の [[wikilinks]]、およびフロントマターのタイトルを特定してください。

page_type の確認： ページのフロントマターから page_type フィールドを読み取ります。

• 存在しない場合： コンテキスト内にすでにあるスキーマの列挙値を使い、ページの内容と構成から推定します。書き込む前に推定したタイプをユーザーに提示し、確認してください。「このページには page_type がありません。内容から <type> のように見えますが、これでよいですか？それとも別のタイプにしますか？」 確認された値を記録します。ステップ 6 で updated: とあわせて書き込みます。
• 存在するが、実際の内容に合わなくなっている場合： 現在の page_type がページの実際の範囲と一致しなくなっている場合（例：knowledge ページが比較調査に発展した場合、または stub が充実した内容になった場合）は、タイプの昇格を提案します。「このページは <type> に分類されていますが、現在は <better-type> に近い内容です。ここで page_type を更新しますか？」 自動で昇格させず、明示的な確認を待ってください。

ステップ 2 - ブラックリストを確認する

対象ページがブラックリスト対象のパスにないことを確認します。対象の場合は停止してください。Wiki スキルではブラックリスト対象のパスを変更できません。

ステップ 3 - index.md を確認して更新する

index.md を読みます。対象ページが記載されていない場合は、適切なセクションに次の形式で項目を追加します。 - [[Page Title]]: 150 文字以内の一文による説明。 \relative/path/to/page.md``

すでに記載されている場合は、説明が引き続き正確か確認します。大幅に古くなっている場合は更新してください。

ステップ 4 - 関連ページを探す

インデックスのカタログから、トピックに実質的な重なりがある候補ページを 3～8 件選びます。関連付けは意味のあるものにし、単なるキーワードの一致にとどめないでください。

ステップ 5 - 候補ページを読む

各候補を最後まで読みます。共通の概念がある、一方がもう一方を発展させている、または両方を知ることで読者に利点がある、といった実質的な関連があることを確認します。実際の関連がない候補は除外してください。

ステップ 6 - バックリンクを追加する

関連が確認された各ページの組み合わせについて、両方向にリンクを追加します。

• 対象ページ：自然な箇所に [[Candidate Page Title]] を追加します
• 候補ページ：自然な箇所に [[Target Page Title]] を追加します

新しい Wiki リンクだけを書き込み、候補ページの内容を再構成したり書き直したりしないでください。書き込む前に、各候補がブラックリスト対象でないことを確認します。

書き込みを行ったすべてのページ（対象ページと、リンクを受け取った各候補ページ）について、フロントマターの updated: フィールドも今日の日付に更新します。ステップ 1 で page_type の値を推定して確認済みの場合は、この時点で対象ページのフロントマターに書き込みます。その他のフロントマターフィールドはすべて変更しないでください。

ステップ 7 - log.md の先頭に追加する

新しい項目を log.md の先頭、ヘッダー行の下、既存の項目より上に追加します。

## [YYYY-MM-DD] integrate | <Target Page Title>
Added to index.md. Linked from: [[Page A]], [[Page B]]. Linked to: [[Page C]].

ステップ 8 - 要約する

対象ページを index.md に追加したかどうか、そのページにリンクするようになったページ、そのページからリンクするようになったページ、および除外した関連性とその簡潔な理由を報告します。

主なルール

1. コンテンツは変更しません： Wiki リンクとインデックス項目を追加するだけで、書き換えたり再構成したりしません
2. ブラックリストに登録されたパスには書き込まないでください
3. リンクは実際の関連性に基づいて追加してください： 本当に関連がある場合にのみリンクを追加してください
4. 候補ページへの変更は最小限にしてください： 新しい Wiki リンクのみを追加してください
5. 1 回の実行につき対象は 1 つです
6. archive/ または assets/ のページは統合しないでください