wiki-query

Wiki クエリ

コンパイル済みの Wiki から情報を読み取り、統合して質問に回答します。

---

設定の検出

すべての実行はここから始まります。 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）を読み込み、ワークフローに進みます。

   • 欠落している → 停止します。先に進んではいけません。デプロイしてはいけません。応答は <available_skills>（手順 3）に wiki-config があるかどうかによって異なります：

     • wiki-config が利用可能： 次のパターンをそのまま出力します — 「Wiki に wiki-schema.md がありません。デプロイしてセットアップを完了するには、/wiki-config を実行してください。完了するまで待機します。」 ターンを終了します。同梱版のデプロイを提案してはいけません。代替案を提示してはいけません。wiki-config が利用可能な場合は、ガイド付きフローを使用するのが適切です。

     • wiki-config が利用不可： 同梱版によるフォールバックを提案します — 「Wiki に wiki-schema.md がなく、wiki-config スキルもインストールされていません。同梱のリファレンスからデフォルトをデプロイできますが、ガイド付きセットアップのために wiki-config をインストールすることをおすすめします。同梱のデフォルトをデプロイしますか？」 明示的な確認を待ちます。「はい」と確認されたら、references/wiki-schema.md からデプロイします。

   • 形式不正 → 停止します。以下の同じ分岐に従います：

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

     • wiki-config が利用不可： 手動修復の手順について、references/setup-help.md を案内します。ユーザーが明示的にリセットを指示した場合（自動的なフォールバックではない場合）は、カスタマイズ内容が上書きされることを警告し、明示的な確認後にデフォルトをデプロイします。

   手順 4 で wiki-config.md 自体の形式が不正と判明した場合も、同じ二分岐を適用します。wiki-config が利用可能 → 停止して /wiki-config の実行を推奨し、ターンを終了します。利用不可 → setup-help.md を使ったガイド付きの手動修復を案内します。

6. 設定が見つからない場合：Wiki のルートパスをユーザーに尋ね、その場所を検索します（最大 5 階層まで）。それでも見つからない場合は、Wiki がまだありません。上記の「欠落」分岐に従います（/wiki-config を推奨し、利用できない場合は同梱版のデプロイを提案します）。

---

必要な機能

このスキルにはファイルシステムの読み取りアクセスが必要です。書き込みアクセスが必要なのは、ユーザーが回答を新しい Wiki ページとして記録する場合のみです。

ファイルシステムツールのない環境（Web、モバイル）で実行している場合、このスキルではローカルのナレッジベースにアクセスできないことをユーザーに伝えます。代わりに、Wiki 固有のコンテキストは参照できないことを明記したうえで、一般的なモデル知識に基づく回答を提案します。

ワークフロー

Config Discovery により、wiki-config.md と wiki-schema.md はすでにコンテキストに読み込まれています。再度読み込まず、両方が利用可能であることを前提に、ここから進めてください。

ステップ 1 - 目安を得るためにインデックスを読む

Wiki のルートにある index.md を読みます。カタログ全体に目を通し、クエリに関連しそうなページを特定します。すべてのページを読む必要はありません。1 行の説明を使って、検索対象を絞り込んでください。

クエリが広範囲にわたる場合や複数の領域にまたがる場合は、Overview.md も読みます。現在の知識の状態をすばやく把握できます。

ステップ 2 - 対象ページを特定する

クエリに関連する情報を含んでいる可能性が最も高いページを 2～6 件選びます。以下を考慮してください。

• トピックの直接的な一致（ページのタイトルまたは説明に対象が記載されている）
• 領域との関連性（クエリが FASD に関するものであれば、FASD のページを読む）
• 領域をまたぐ関連性（クエリが複数のセクションにまたがる場合がある）

クエリが非常に具体的な場合は、対象を絞ったページを優先します。広範囲にわたる場合は、Overview.md から始めて、バックリンクをたどってください。

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

特定したページをそれぞれ最後まで読みます。クエリへの直接的な回答、関連する背景情報、関連する他のページへの Wiki リンク、メモで指摘されている情報の不足や未解決の疑問に注意してください。

ステップ 4 - 必要に応じてバックリンクをたどる

最初に読んだページで、直接関連すると思われる他のページが参照されている場合は、それらも読みます。追加で読むページは 2～3 件までにしてください。新しいページから関連情報が得られなくなった時点で終了します。

ステップ 5 - 回答をまとめる

クエリに対する明確な回答を作成します。

• すべての主張を、[[wikilink]] の引用を使って具体的な Wiki ページに基づかせます
• 十分な根拠のある主張、微妙な補足が必要な主張、未解決の疑問や情報の不足を区別します
• Wiki の言葉遣いと視点に沿います
• Wiki に記載されていることと、記載されていないことを正直に伝えます。一般的なモデルの知識で不足を補う場合は、そのことを明示してください

形式：説明的な回答には文章を、比較や構造化された情報には表やリストを使います。

ステップ 6 - 回答のページ化を提案する

回答を提示した後、次のように提案します。「この回答を今後の参照用に新しい Wiki ページとして保存できます。ページを作成しますか？」

ユーザーが同意した場合：

• 適切なセクションに新しい Wiki ページを作成します
• フロントマター（title、version、date、changes: "Created by wiki-query"）を含めます
• 引用したソースページへの [[backlinks]] を追加します
• wiki-integrate を実行して、ナレッジグラフに組み込みます
• log.md の先頭（ヘッダー行の下、既存のエントリーより上）に、次の内容を追加します：## [YYYY-MM-DD] query | <query summary>

ユーザーが断った場合は、ファイルを変更しないでください。

---

クエリの対象範囲

対象： ブラックリストに含まれるパスを除き、Wiki ルート内のすべての Wiki ページ。 対象外： raw/ のソースファイル。Wiki は統合された情報であり、生のソースではありません。

クエリへの回答に raw ソースファイルでのみ得られる情報が必要な場合は、その旨を伝え、ソースがまだ処理されていなければ wiki-ingest の実行を提案してください。

---

主なルール

1. 一般知識ではなく Wiki を引用する： 事実に関する主張はすべて、具体的な Wiki ページを根拠とする必要があります
2. 情報の不足を正直に伝える： Wiki に回答が記載されていない場合は、明確に伝えてください
3. ユーザーが明示的に依頼しない限り、ファイルを変更しない： 読み取りは常に安全ですが、書き込みには同意が必要です
4. ブラックリストに含まれるパスにはアクセスしない： クエリへの回答のためであっても、読み込まないでください