Community写作与编辑github.com

steipete/obsidian

Obsidian 知识库:搜索、读取、写入笔记、反向链接、Bases、Canvas。

obsidian 是什么?

该技能使 AI 助手能够与本地 Obsidian 知识库无缝交互,支持笔记搜索、读取、写入、移动以及管理反向链接、Bases 和 Canvas 等高级特性。它优先使用 Obsidian 官方 CLI 进行知识库感知的查询(如搜索、反向链接和属性),同时也支持直接文件系统读取以获取精确字节。对于写入操作,技能提供多种路径:创建新笔记、追加/前置每日笔记、使用 apply_patch 编辑文件,以及通过 CLI 重命名/移动笔记以自动更新链接。技能明确规定了安全准则:不进行批量重写、不编辑 .obsidian 配置目录、不删除笔记(除非用户明确要求),并保持前端 YAML 和维基链接不变。它适用于任何标准 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="- Follow-up item"

对于多行内容,优先在知道路径后使用 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 和维基链接,除非任务是对它们进行重构。
  • 如果存在多个知识库,不要猜测;使用 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.

相关技能