knowledge
Installation
SKILL.md
Knowledge — Obsidian ナレッジ管理
Obsidian vault を Zettelkasten 方式で管理するスキル。調査結果の保存、既存ナレッジの検索、デイリーノート管理、ノートの整理・リンク構築を行う。
Vault
- vault 名: 環境変数
OBSIDIAN_KNOWLEDGE_VAULTで指定する。CLI にはvault="$OBSIDIAN_KNOWLEDGE_VAULT"として渡す - 未設定の場合は選択した CLI の
vaultsで候補を提示し、今回使う vault をユーザーに確認する。あわせて、毎回の確認を省くためOBSIDIAN_KNOWLEDGE_VAULTを設定するよう推奨する - vault パスが必要な時(filesystem フォールバックなど)は選択した CLI の
vaults verboseの出力から該当 vault 名の行のパスを取得する - 関連スキル:
obsidian-cli(CLI操作)、obsidian-markdown(Markdown構文)
CLI と filesystem の使い分け
全操作で CLI を優先する。まず command -v obsidian-cli を確認し、あれば obsidian-cli を使う。なければ command -v obsidian を確認して obsidian を使う。Nix 環境では obsidian が GUI 本体を指す場合があるため、この順序を守る。選択した CLI に $OBSIDIAN_KNOWLEDGE_VAULT を vault= 引数として渡し、目的のコマンド(search, read, create, append, daily:read, daily:append など)を実行する。
- 例(
obsidian-cliがある場合):obsidian-cli vault="$OBSIDIAN_KNOWLEDGE_VAULT" search query="test" create/appendはデフォルトでファイルを開かない。エディタで開きたい時だけopenを付ける
CLI が無い・落ちる・対象コマンドが失敗する場合は filesystem 操作にフォールバックし、vault ディレクトリ内の .md ファイルを直接読み書きする。vault パスは選択した CLI の vaults verbose が使えればその出力から取得し、CLI 自体が使えない場合はユーザーに確認する。書き込みは obsidian-markdown スキルの構文規約に従って frontmatter + 本文を構成し、書き込み権限が無ければユーザー承認を取る。