wiki

Wiki オーケストレーション

インストールされた製品はコードとして、選択されたユーザーボルトはデータとして扱います。現在のディレクトリがたまたま製品のチェックアウト先であっても、プラグイン／製品のルートをボルトとして使用してはいけません。

このスキルのインストール先からポータブルコアを解決し、絶対パスで呼び出します。

CORE=/absolute/product/root/scripts/claude-obsidian.py
python3 "$CORE" --help

ボルトは次の順序で解決します。明示的な --vault、CLAUDE_OBSIDIAN_VAULT、最も近い .claude-obsidian.json、その後、現在のディレクトリ以上の階層にある、初期化済みで曖昧さのないボルトです。選択先が未指定または曖昧な場合は、安全側に倒して処理を中止します。

基本セットアップにネットワークアクセスは不要です。ユーザーが取得先と予算を別途承認しない限り、テンプレート、プラグイン、リモートコンテンツを取得してはいけません。

ボルトをセットアップする

決定的なセットアップコマンドを使用します。どちらもデフォルトではドライランです。

新規の独立したボルトの場合：

python3 "$CORE" init /absolute/path/to/vault \
  --generated-at <ISO-UTC> --operation-id init-reviewed
python3 "$CORE" init /absolute/path/to/vault \
  --generated-at <ISO-UTC> --operation-id init-reviewed \
  --approved-plan-sha256 <reviewed-sha256> --apply

既存の Obsidian ボルトの場合：

python3 "$CORE" adopt /absolute/path/to/vault \
  --generated-at <ISO-UTC> --operation-id adopt-reviewed
python3 "$CORE" adopt /absolute/path/to/vault \
  --generated-at <ISO-UTC> --operation-id adopt-reviewed \
  --approved-plan-sha256 <reviewed-sha256> --apply

--apply の前に、選択されたパスと変更パスのプレビューを表示し、出力された approved_plan_sha256 を変更せずに渡します。ユーザーが競合を確認し、置き換えを明示的に承認していない限り、--force を使用してはいけません。セットアップはデフォルトで非破壊的であり、上流の Git リモートを作成しません。

ユーザーが特定ドメイン向けのひな形を求めた場合は、まず基本セットアップを行ってから、modes.md を読みます。追加ページと設定は、1 つの操作レベルのトランザクションとして作成します。ホストの Write/Edit ツールや Obsidian トランスポートを使って、ボルトのファイルを変更してはいけません。

操作を振り分ける

ユーザーの意図を、暗黙のうちに範囲を広げずに振り分けます。

意図	スキル
提供されたソースを取り込む	wiki-ingest
既存のボルト内の知識に基づいて回答する	wiki-query
特定の会話の結果を保存する	save
予算内で公開ウェブを調査する	autoresearch
ボルトの健全性を確認する	wiki-lint
引用付き用語集を作成する、または重複するノートを統合する	明示的に確認した範囲で wiki-ingest
ログ項目をまとめる	wiki-fold
キャンバスを操作する	canvas

クエリは読み取り専用です。クエリからの永続化は、明示的に範囲を分けた Save 操作として行う必要があります。セッションが終了したというだけで、会話の記録を保存したり、ホットキャッシュを更新したりしてはいけません。

変更の契約

カスタムのひな形作成や変更の前に、operation-transactions.md を読みます。1 つの論理操作では、検査可能で復旧可能な claude-obsidian.transaction.v1 バンドルを 1 つ作成する必要があります。並列エージェントから返せるのは下書きと根拠だけです。オーケストレーターがそれらを統合し、1 回だけ適用します。正規ページの作成または削除には、すべて、そのバンドル内でアクティブなインデックスまたは MOC の更新を含めます。概要を更新するのは、安定した全体像が変わった場合に限ります。生のソースペイロードは新規作成のみ可能です。自動コミットはありません。

ソース台帳や主張台帳を初期化または変更する際は、provenance.md を使用します。裏付けのない証拠は、裏付けのないままにします。ソース、引用、日付、位置情報、確信度を捏造してはいけません。

適用が成功したら、操作 ID と変更されたパスを正確に報告します。ユーザーが Git のチェックポイントを明示的に希望した場合は、別途実行します。

python3 "$CORE" checkpoint OPERATION_ID --vault /absolute/path/to/vault

競合が発生した場合は、再読み込みして再構築します。中断された場合は、transaction recover を使用します。同一のバンドルである場合に限り、操作 ID を再利用します。

インストール環境

インストール方法やホストの挙動が重要な場合は、install-modes.md を読みます。フックは任意のアダプターです。ポータブルな動作はコアとスキルにあります。

条件付き参照

現在の依頼に必要な参照のみを読みます。

• プロパティスキーマを定義または採用する場合は、frontmatter.mdを参照します。
• Obsidian のビジュアルカスタマイズを依頼された場合は、css-snippets.mdを参照します。
• ローカル Git またはチェックポイントの明示的なセットアップについては、git-setup.mdを参照します。
• オプションの Obsidian インテグレーションを評価する場合は、plugins.mdを参照します。
• 外部読み取りトランスポートの評価をユーザーが依頼した場合は、mcp-setup.mdを参照します。
• Local REST API アダプターをユーザーが明示的に利用中、またはリクエストしている場合に限り、rest-api.mdを参照します。
• 既存のオプションの Dataview セットアップについては、dataview.mdを参照します。
• 引用付きの用語集作成や統合の作業については、knowledge-recipes.mdを参照します。
• 外部エディターや複数のマシンについては、coordination.mdを参照します。
• バージョン管理されたネイティブの受け入れ証拠については、native-conformance.mdを参照します。
• サイズ制限や復旧可能なレガシーの圧縮については、capacity-and-recovery.mdを参照します。
• 固定された外部の構文や設計の参照を照合する場合は、upstream-references.mdを参照します。
• モデルを評価する場合、生成アダプターを変更する場合、またはホスト固有のプロンプトを検証する場合は、model-guidance.mdを参照します。

考え、検証し、成長する

適用する前に一度立ち止まり、既存の状態を確認し、Vault の選択と根拠を検証してから、依頼を満たす最小限かつ取り消し可能な操作を選びます。その後、不確実な点と次に役立つ改善案を報告します。ユーザーの指示なしに改善を実行することはありません。