obsidian-wiki-ingest

Obsidian Wiki 取り込み — 自動化スキル

あなたは、Obsidian wiki プロジェクトにドキュメントを取り込む自動化レイヤーです。このスキルは取り込みワークフローを調整し、重複の排除、適切なフロントマター、既存ページとの相互リンクを確実に行います。

トリガー

• ユーザーが「wiki に取り込む」「wiki に追加する」、または obsidian-wiki リポジトリを対象とする表現を使った場合。
• コンテキスト：/home/ubuntu/projects/obsidian-wiki ワークスペースで作業中。

担当する処理

• 環境とマニフェストの状態から、対象の Vault パスを検証します。
• ユーザーの入力またはソースの変更に基づいて、Append、Full、Raw の取り込みモードから選択します。
• wiki-ingest ワークフローを呼び出して、新規または変更されたソースを処理します。
• 取り込みメタデータを使って、マニフェストとログファイルを更新します。
• 必要に応じて、プロジェクト概要ページと相互リンクを作成または更新します。

入力

• OBSIDIAN_SOURCES_DIR または _raw/ にあるソースドキュメント（Markdown、PDF、テキスト、画像）
• OBSIDIAN_VAULT_PATH から取得する Vault パス
• 任意：取り込みモード（append|full|raw）

出力

• 知識を要約した、更新済みの wiki ページ
• 更新済みの .manifest.json とログエントリ
• 任意：新規または更新済みのプロジェクト概要ページ

調査と安全性

• シークレットや機密データを取り込まないでください。
• 既存ページの構成を尊重し、コンテンツの重複を避けてください。
• 推測された知識や曖昧な知識には、出典を示す注記を付けてください。

ワークフローの例（概要）

1. 取り込みモードと対象パスを決定します
2. 選択したモードで wiki-ingest を実行します
3. マニフェストとログを更新し、wiki インデックスを更新します
4. 変更内容の簡単な概要を返します

次のステップ

• 承認いただければ、現在のプロジェクトの取り込みを開始してマニフェストを更新する、小さなラッパースクリプト（scripts/ingest-wiki.sh）を作成します。その後、CLI からこのスキルを呼び出すための簡単なコマンドエイリアスを設定します。

Vault への書き込み後の QMD 更新

QMD は検索インデックスであり、信頼できる唯一の情報源ではありません。$QMD_WIKI_COLLECTION が空または未設定の場合は、この手順をスキップしてください。このスキルが Vault の Markdown を書き込みまたは書き換えた後にのみ実行します。QMD の更新に失敗しても、Vault の変更はロールバックしないでください。QMD の状態は別途報告してください。

$QMD_CLI が設定されている場合はそれを使用し、そうでなければ qmd を使用します。

${QMD_CLI:-qmd} update

出力にベクターが必要、または埋め込みが古い可能性があると表示された場合は、次を実行します。

${QMD_CLI:-qmd} embed

次のいずれかでコレクションを検証します。

${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION"

または、特定のページパスがわかっている場合は、次を実行します。

${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5

次のいずれかを記録します。

• QMD refreshed: update + embed + verified
• QMD refreshed: update only + verified
• QMD skipped: QMD_WIKI_COLLECTION unset
• QMD skipped: qmd CLI unavailable
• QMD failed: <short error summary>