llm-wiki-maintainer

LLM Wiki メンテナー

概要

このスキルは、Obsidian 互換の Wiki 成果物としてコンパイルされ、継続的にメンテナンスされる Markdown ナレッジベースに使用します。

優先順位：

1. 新規セットアップ／デプロイ／初期化の依頼では、デフォルトで Ar9av/obsidian-wiki をデプロイします。
2. Ar9av/obsidian-wiki フレームワークが存在する場合は、そちらを優先します。
3. 既存のレガシーな raw/ + wiki/ LLM Wiki がある場合は、壊さずに作業しつつ、obsidian-wiki への移行を提案します。
4. レガシー形式を作成または拡張するのは、ユーザーが旧標準の LLM Wiki 形式を明示的に依頼した場合に限ります。

Wiki は単なるメモの寄せ集めではなく、メンテナンス対象のシステムとして扱います。

デフォルトのデプロイ動作

ユーザーがセットアップ、デプロイ、初期化、新規 Wiki のためにこのスキルを実行し、既存の Wiki の仕様を維持する必要がない場合は、デフォルトの実装として Ar9av/obsidian-wiki をデプロイします。

デフォルトのデプロイでは、次のことを行います。

1. https://github.com/Ar9av/obsidian-wiki から取得した obsidian-wiki リポジトリとして、対象ディレクトリを作成または設定します。
2. 対象ディレクトリ内の既存ユーザーファイルを保持します。
3. OBSIDIAN_VAULT_PATH を対象 Vault に設定した .env を作成します。
4. Vault のファイルとディレクトリを初期化します。
   • index.md
   • log.md
   • hot.md
   • .manifest.json
   • .obsidian/
   • _meta/
   • _raw/
   • _archives/
   • concepts/、entities/、skills/、references/、synthesis/、 journal/、projects/
5. 安全に行える場合は、~/.obsidian-wiki/config が選択した Vault／リポジトリを指すようにします。
6. ユーザーから完全な upstream の setup.sh の実行を求められない限り、必要な Codex スキルのシンボリックリンクのみを ~/.codex/skills にインストールします。
7. リポジトリの origin が Ar9av/obsidian-wiki の場合、ローカルの Vault 成果物が誤って upstream にコミットされないようにして、upstream フレームワークの Git の状態をクリーンに保ちます。

「set up my wiki」、「разверни wiki」、「создай Obsidian wiki」など、依頼が単に Wiki のセットアップである場合、レガシー形式にするかどうかをユーザーに尋ねないでください。ユーザーが旧形式を明示的に指定しない限り、obsidian-wiki を使用します。

レガシー LLM Wiki との互換性

レガシーモードは、次のような標準的な LLM Wiki の既存レイアウトがある場合に使用します。

• WIKI-SCHEMA.md
• raw/
• wiki/index.md
• wiki/log.md
• wiki/sources/
• wiki/concepts/、wiki/entities/、wiki/analyses/

レガシーモードが検出された場合：

1. 既存のレイアウトを安全に使用します。
2. 明示的な承認なしに、レガシー Wiki を移動、名前変更、書き換えしないでください。
3. 現在の Wiki がレガシー／標準 LLM Wiki であることをユーザーに伝えます。
4. 旧構造を維持する明確な理由がない限り、今後の作業に向けて Ar9av/obsidian-wiki への移行を推奨します。
5. 次の移行方法を提示します。
   • raw/ をソース資料として保持するか、_raw/ に割り当てます。
   • wiki/sources/ を references/ に割り当てます。
   • wiki/concepts/ を concepts/ に割り当てます。
   • wiki/entities/ を entities/ に割り当てます。
   • wiki/analyses/ を synthesis/ に割り当てます。
   • wiki/index.md と wiki/log.md をルートの index.md と log.md に変換します。
   • .manifest.json、hot.md、_meta/、.obsidian/ を作成します。

ユーザーが移行を依頼するか、明確に許可した場合に限り、移行を実行します。

Obsidian-Wiki の優先事項

次のいずれかが存在する場合は、obsidian-wiki モードを使用します。

• .skills/llm-wiki/SKILL.md
• .skills/wiki-ingest/SKILL.md、.skills/wiki-query/SKILL.md、または関連する wiki スキル
• Obsidian Wiki のエージェントコンテキストで始まる AGENTS.md
• OBSIDIAN_VAULT_PATH を含む .env
• ~/.obsidian-wiki/config
• .manifest.json、hot.md、_meta/taxonomy.md、_raw/ などの Vault ファイル

このモードでは、ローカルの慣習より先にフレームワークの契約に従います。

1. 設定を解決します。
   • CWD から上位へたどり、OBSIDIAN_VAULT_PATH を含む .env を探します。
   • 見つからない場合は、~/.obsidian-wiki/config を読みます。
   • 解決された OBSIDIAN_VAULT_PATH が Vault のルートです。
   • 解決された OBSIDIAN_WIKI_REPO がある場合、それがフレームワークリポジトリです。
2. 制御ファイルを読みます。
   • リポジトリに AGENTS.md がある場合は読みます。
   • 次に、$OBSIDIAN_VAULT_PATH/AGENTS.md がある場合は読みます。こちらは所有者固有の規約について、フレームワークの既定値を上書きします。
   • 操作に固有の作業では、実行前にリポジトリ内の対応する .skills/<skill-name>/SKILL.md を読みます。
3. obsidian-wiki の Vault 構成を使用します。
   • ルートの特別なファイル：index.md、log.md、hot.md、.manifest.json。
   • メタデータ：_meta/、_raw/、_archives/、.obsidian/。
   • カテゴリ：concepts/、entities/、skills/、references/、 synthesis/、journal/、projects/。
4. 検出された契約でレガシーパスが明示的に使用されている場合を除き、コンパイル済みレイヤーは wiki/ ではなく Vault のルートカテゴリに配置します。

この環境のローカル既定値：

• $HOME/TG-NEWS-151 は obsidian-wiki のリポジトリ兼 Vault です。
• $HOME/.obsidian-wiki/config はその Vault を指しています。

クイックスタート

1. 契約を確認します。
   • まず上記のルールに従って obsidian-wiki モードかどうかを検出します。
   • obsidian-wiki モードでは、.env または ~/.obsidian-wiki/config を解決し、AGENTS.md を読み、続いて Vault の index.md、log.md、hot.md を読みます。
   • レガシーモードでは、Vault に WIKI-SCHEMA.md がある場合、最初に読みます。
   • 次に、ローカルに AGENTS.md があれば読みます。
   • その後、レガシーの wiki/index.md と wiki/log.md を読みます。
   • 契約が存在せず、タスクがセットアップ／初期化／デプロイの場合は、既定で obsidian-wiki をセットアップします。
   • ワークスペース全体を対象とする Vault では、コーパスポリシーのページがある場合、取り込み前に読みます。
2. ソースの境界を守ります。
   • 明示的に編集を指示されない限り、_raw/、raw/、外部コーパスファイルは読み取り専用として扱います。
   • obsidian-wiki モードでは、コンパイル済みのナレッジは references/、concepts/、entities/、synthesis/、 journal/、projects/ などの Vault カテゴリディレクトリにのみ書き込みます。
   • レガシーモードでは、コンパイル済みのナレッジは wiki/ にのみ書き込みます。
3. 操作を選びます。
   • ingest
   • query
   • lint

使用する場面

• ユーザーが LLM Wiki、Obsidian、vault、raw/、wiki/、 wiki/index.md、wiki/log.md、WIKI-SCHEMA.md、または AGENTS.md に言及している場合。
• ユーザーが obsidian-wiki、Ar9av/obsidian-wiki、.manifest.json、 .skills/wiki-*、_raw/、hot.md、wiki-status、wiki-ingest、または wiki-query に言及している場合。
• 取り込み前にソースファイルを Markdown に変換するタスク、またはユーザーが MarkItDown、markitdown、ドキュメントから Markdown への変換、 PDF/DOCX/PPTX/HTML のインポートに言及している場合、あるいは Wiki 用の生のソース資料の準備を依頼している場合。
• ユーザーがソースを取り込む、Wiki をもとに回答する、矛盾を調整する、または永続的なナレッジベースを維持することを求めている場合。
• ユーザーが次のようなロシア語のプロンプトを使用している場合：
  • добавь в вики
  • сделай ingest
  • обнови index/log
  • lint wiki
  • разложи по вики

ワークフロー

Obsidian-Wiki の操作ルーティング

obsidian-wiki モードでは、対応するフレームワークスキルの指示を優先してください。

• セットアップまたは修復: .skills/wiki-setup/SKILL.md を読みます。
• 取り込み: .skills/wiki-ingest/SKILL.md を、または生のテキストやエクスポートデータの場合は .skills/data-ingest/SKILL.md を読みます。
• クエリ: .skills/wiki-query/SKILL.md を読みます。
• ステータス/差分: .skills/wiki-status/SKILL.md を読みます。
• Lint: .skills/wiki-lint/SKILL.md を読みます。
• 再構築/アーカイブ: .skills/wiki-rebuild/SKILL.md を読みます。
• 相互リンク: .skills/cross-linker/SKILL.md を読みます。
• タグ: .skills/tag-taxonomy/SKILL.md を読みます。
• プロジェクト同期: .skills/wiki-update/SKILL.md を読みます。

要求されたワークフローがインストール済みの obsidian-wiki スキルですでにカバーされている場合は、この汎用スキルからタスクを解釈し直すのではなく、そのスキルの契約に従ってください。

取り込み

新しいソース、フォルダ、ノート、またはワークスペースの一部を持続的な ナレッジにすべき場合に使用します。

obsidian-wiki モードの場合:

1. 設定を解決し、制御ファイルを読みます。
2. ソースを変更せずに注意深く読みます。
3. 操作固有のスキルが別のカテゴリが適切だと示していない限り、 references/ にソース/参照ページを作成または更新します。
4. 必要に応じて concepts/、entities/、skills/、synthesis/、 journal/、または projects/ の持続的なページを更新します。
5. index.md、log.md、hot.md、および .manifest.json を更新します。
6. フレームワークのテンプレートに従う際は、sources、summary、 provenance、base_confidence、lifecycle、created、updated などの frontmatter フィールドで来歴を保持します。

レガシーモード:

手順:

1. ソースを注意深く読みます。
2. wiki/sources/ に1つのソースページを作成または更新します。
3. 影響を受ける持続的なページを wiki/entities/、 wiki/concepts/、または wiki/analyses/ で更新します。
4. wiki/index.md を更新します。
5. wiki/log.md にエントリを追記します。

ルール:

• 実用的な場合は、ソース項目ごとに1つのソースページを優先します。
• 密接に関連するドキュメントの場合は、1つのバンドルソースページを使用し、 すべてのメンバーを sources に列挙します。
• 来歴を保持します。ソース資料をその場で書き換えないでください。

MarkItDown 支援による取り込み

ソース資料が markdown 以外の形式で存在し、内容をでっち上げることなく wiki 取り込み用に準備すべき場合に使用します。

典型的なケース:

• PDF
• DOCX
• PPTX
• HTML
• コピーしたエクスポートや、markdown 変換後に取り込む方が容易な ダウンロード済みソースバンドル

ルール:

• 明示的に指示されない限り、元のファイルは読み取り専用として扱います。
• obsidian-wiki モードでは、変換された成果物をコンパイル済みカテゴリフォルダではなく、 _raw/ または明示的に選択した別のステージング領域に書き込むことを優先します。
• レガシーモードでは、変換された成果物を wiki/ ではなく、 raw/ または明示的に選択した別の取り込みステージング領域に書き込むことを優先します。
• 元のソースファイルを変換された markdown で上書きしないでください。
• 変換後、変換された成果物をソースとして取り込み、元のパスへの来歴を保持します。
• 変換品質が低い場合は、markdown が信頼できるふりをせず、その旨を明示します。

ローカルツールに関する注意:

• ローカルの MarkItDown 環境が次の場所にあります: $HOME/LLM Wiki MarkItDown/MarkItDown/venv/bin/markitdown
• ローカルで確認されたインストール済みバージョン: markitdown 0.1.5

実践的なワークフロー:

1. 元のソースファイルを特定します。
2. ローカルの markitdown でそれをステージング markdown ファイルに変換します。
3. 元のファイルはそのままにしておきます。
4. 変換された markdown を批判的に読みます。
5. obsidian-wiki モードでは、その変換されたソースから1つの references/ ページを作成/更新し、 その後、持続的なページ、index.md、log.md、hot.md、 および .manifest.json を更新します。
6. レガシーモードでは、その変換されたソースから1つの wiki/sources/ ページを作成/更新し、 その後、持続的なページ、wiki/index.md、および wiki/log.md を更新します。

クエリ

ユーザーが wiki で回答すべき質問をしたときに使用します。

obsidian-wiki モードの場合:

1. まず設定を解決し、index.md、hot.md、および関連する frontmatter の 要約を読みます。
2. 関連する永続ページは必要なときだけ読みます。
3. まず wiki から回答し、[[wikilink]] 形式の引用を付けます。
4. wiki で不十分な場合は、不足しているソースまたはページを明示します。

レガシーモード:

手順:

1. まず wiki/index.md を読んで全体像をつかみます。
2. 関連する永続ページを読みます。
3. まず wiki から回答します。
4. 関連するページを [[wikilinks]] で引用します。
5. 回答が永続的なものであれば、新しい分析ページを保存するか提案します。

ルール:

• ソースの事実と推論を無言で混ぜないでください。
• wiki で不十分な場合は、何が不足しているかを述べてください。

Lint

ユーザーが wiki の品質管理を求めたときに使用します。

チェック項目:

• 壊れたリンク
• 孤立したページ
• つながりの弱いページ
• 重複または内容が重なるページ
• 矛盾
• 独自のページを持たないまま繰り返し言及されている概念やエンティティ
• 古くなった主張や置き換えられたページ

安全な場合は直接修正します:

• 壊れたリンク
• インデックスのずれ
• 明らかに正当な、欠落しているバックリンク
• 明白なページ配置やタイトルの整理
• obsidian-wiki モードにおける古い hot.md または .manifest.json メタデータで、 修正が機械的かつソースに裏付けられている場合

判断が必要な場合は推測せず報告します。

ページの規律

• 断片的なページを新規作成するよりも、永続ページを更新することを優先します。
• ソースページは事実に基づくものに、永続ページは統合的なものに保ちます。
• YAML frontmatter を有効な状態に保ちます。
• 意味のある wikilink を維持します。
• obsidian-wiki モードでは、index.md、log.md、hot.md、および .manifest.json を最新の状態に保ちます。
• レガシーモードでは、wiki/index.md と wiki/log.md を最新の状態に保ちます。
• 主張に信頼できる裏付けがない場合は、その旨を明示します。

真実性のルール

• 事実を捏造しないでください。
• ソースに裏付けられた事実と統合を区別します。
• 不確実性を明示的に保持します。
• 出典、引用、ソース数、ページリンクを決して捏造しないでください。

アーキテクチャに関する注意

• wiki がソフトウェアを説明している場合、アーキテクチャページは 実装ページと分けておきます。
• システムや製品を比較する場合、まず両方を取り込み、その後で 統合ページを書きます。
• ユーザーがチャットで直接テキストを提供した場合、それをソースノートとして 扱い、その出典をソースページ本文に記録します。
• 取り込んだソース素材が最初に MarkItDown を経由する場合、結果として得られる ソースページまたは出典ノートに、元のファイルパスと変換後の markdown パスの 両方を、有用な場合は保持します。

ローカル例

この環境で実際に動作する vault については、 references/artigram-example.md を参照してください。

この環境におけるローカルの変換指向のセットアップについては、以下に注意してください:

• wiki スケルトン: $HOME/LLM Wiki MarkItDown/LLM Wiki
• MarkItDown venv: $HOME/LLM Wiki MarkItDown/MarkItDown/venv