Community寫作與編輯github.com

steipete/obsidian

Obsidian 知識庫:搜尋、讀取、寫入筆記、反向連結、Bases、Canvas。

obsidian 是什麼?

此技能專為與本機 Obsidian 知識庫互動而設計。Obsidian 知識庫本質上是一個包含 Markdown 檔案及 `.obsidian/` 設定資料夾的目錄。技能透過官方 CLI 工具 `obsidian` 提供全面的知識庫操作功能,包括全文搜尋、筆記讀取與寫入、反向連結查詢,以及對 Bases 和 Canvas 等進階功能的支援。它能自動偵測工作目錄以定位正確的知識庫,並在 CLI 未啟用時提供明確的解決步驟。此外,技能也涵蓋了安全操作準則,例如避免大量改寫知識庫、不隨意編輯 `.obsidian/` 設定,以及建議使用 `move` 指令而非直接移動檔案,以確保內部連結的正確更新。整體而言,此技能為 AI 代理提供了一個結構化且安全的途徑,使其能夠像經驗豐富的使用者一樣有效管理 Obsidian 知識庫。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/obsidian

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

obsidian 是做什麼的?

用於處理本機 Obsidian 知識庫。Obsidian 知識庫是一個包含 Markdown 檔案及 .obsidian/ 設定的一般資料夾。

來源

  • 應用程式設定檔:~/Library/Application Support/obsidian/obsidian.json
  • 預設知識庫名稱:obsidian
  • 常見的本機知識庫路徑:~/obsidian
  • 官方 CLI:obsidian
  • 知識庫指令會從目前工作目錄解析知識庫;請在 ~/obsidian 目錄下執行。

初步檢查

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

全域指令如 version 和 vaults 可在知識庫外運作。知識庫內容指令若在 ~/obsidian 之外執行,可能會顯示 Vault not found.。請使用 obsidian commands 而非 obsidian help 來探索 CLI 功能。

如果 obsidian 顯示 CLI 已停用:

  1. 先請使用者啟用設定 -> 一般 -> 進階 -> 命令列介面。
  2. 若你已確認應用程式設定檔結構,~/Library/Application Support/obsidian/obsidian.json 中應包含 "cli": true。
  3. 更改應用程式層級的 CLI 設定後,請重新啟動 Obsidian。

讀取工作流程

建議使用官方 CLI 進行具 Obsidian 感知的查詢:

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json

當你已經知道路徑且需要精確的位元組內容時,可直接讀取檔案系統:

sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"

當資料的新鮮度或知識庫選擇很重要時,請回報你使用了哪個來源。

寫入工作流程

選擇影響範圍最小的寫入路徑:

  • 新增筆記:obsidian create path="Folder/Note.md" content="..."。
  • 附加/前置內容到每日筆記:obsidian daily:append content="..."。
  • 簡單的筆記編輯:在 Markdown 檔案上使用 apply_patch。
  • 重新命名/移動筆記:建議使用 obsidian move path="Old.md" to="Folder/New.md",以便連結能自動更新。
  • 寫入後開啟 UI:僅在有用或使用者要求時才加上 open。

常用指令:

cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- 後續事項"

對於多行內容,建議在知道路徑後,直接使用 apply_patch 編輯 .md 檔案。避免為了長篇文字而使用不必要的 shell 引號。

Bases、Canvas、外掛

先使用 CLI 探索:

cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

對於 .canvas、.base 和 .json 檔案,盡可能以結構化資料讀取/編輯。編輯後請保持格式穩定並驗證 JSON。

安全事項

  • 請勿大量改寫知識庫。應使用精確的路徑並檢視差異。
  • 除非使用者要求或任務明確與設定/外掛相關,否則請勿編輯 .obsidian/。
  • 除非明確要求,否則請勿刪除筆記;建議使用垃圾桶而非永久刪除。
  • 請勿透過 Obsidian URI/CLI 路徑建立隱藏的點開頭資料夾筆記。
  • 除非任務是要重構 frontmatter 和 wikilink,否則請保留它們。
  • 若有多個知識庫,請勿猜測;請使用 obsidian vaults 和 obsidian.json。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相關技能