Obsidian-skills 实用上手指南在 Obsidian 里写、跟、沉淀项目战略【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skillsObsidian-skills 是一套面向 Obsidian 的 Agent 技能包教 AI 代理正确读写 Obsidian 风格的 Markdown、Bases 视图和 JSON Canvas并调用 Obsidian CLI 操作笔记库。装好之后你可以直接让代理创建战略文档、搭建任务表格、生成路线图画布而不用自己查阅各种语法规范。本文覆盖安装方式、最小可用流程和常见问题排查。适合哪些场景上手前先确认你是否属于下面几类情况属于其中任意一条这套技能就值得引入个人知识管理阅读网页资料时希望代理把正文提取干净后直接整理成库内笔记而不是粘贴一大段带导航和广告的杂讯。小团队项目推进项目有战略目标、任务拆分和进度状态你希望在 Obsidian 里集中跟踪而不是散落在聊天窗口和表格里。战略文档沉淀需要定期回顾决策过程希望相关笔记、任务表和路线图能互相引用下次打开还能看全貌。核心能力先认识这四个模块技能包共五个模块入门阶段重点理解四个即可obsidian-markdownSKILL.md教会代理 Obsidian 特有的 wikilink、callout、frontmatter 等语法解决“代理写的笔记在 Obsidian 里渲染不出来”的问题。obsidian-basesSKILL.md创建.base视图文件按属性过滤笔记生成表格和卡片列表是把笔记变成项目看板的核心。json-canvas创建.canvas文件摆放文本节点、分组和连线适合画路线图与看板式画布完整示例可参考 EXAMPLES.md。obsidian-cliSKILL.md提供obsidian命令读写、搜索、修改运行中 Obsidian 库里的笔记代理从命令行直接操作库。第五个模块 defuddle 用于提取网页正文为干净的 markdown积累外部资料时顺手可用。安装并跑通第一个流程第一步安装技能三种安装方式任选其一插件市场在支持 marketplace 的代理里先添加市场再安装obsidianobsidian-skills。npx skills执行npx skills add并传入仓库地址。手动放置克隆仓库后放进代理对应的技能目录。目录结构因代理而异是新手最容易出错的一步git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills放置位置Claude Code 放在库根目录的.claude文件夹Codex 通常是~/.codex/skillsOpenCode 必须把整个仓库放到~/.opencode/skills/obsidian-skills只拷内部skills文件夹会被忽略。放好后重启代理生效。第二步创建最小战略流程装好后让代理依次做三件事每件事产出一个文件创建一篇“项目战略”笔记frontmatter 写入status: in-progress正文列出目标与任务——这一步验证 obsidian-markdowncallout 和链接语法应一次写对。创建一个任务视图的 base 文件用file.hasTag(task)过滤表格展示字段为标题、状态、截止日期——这一步验证 obsidian-bases 生成的 YAML 是否有效。创建一个 canvas 看板把“待办 / 进行中 / 已完成”做成三个分组节点——这一步验证 json-canvas。三个文件在 Obsidian 里打开都能正常显示最小流程就跑通了。从笔记到执行流程最小流程跑通后把几个模块组合起来用于日常推进跟踪任务状态用 CLI 批量改状态例如obsidian property:set namestatus valuedone file任务一Bases 表格会自动把该任务挪到已完成视图。沉淀外部资料让代理用 defuddle 抓取文章正文存成笔记再用 wikilink 挂回战略笔记资料与战略放同一套链接关系里。定期复盘每月让代理新建复盘笔记用![[任务视图.base]]把表格嵌进正文复盘画布放同目录下次打开既看到数据也看到路线图。组合的关键是三类文件共用同一套 frontmatter 属性笔记里写的、表格里过滤的、画布上归类的都是同一组status、due、tags。属性对不齐时看板就会漏掉该显示的任务。常见问题与排查方法新手容易卡住的三个地方代理识别不到技能先确认目录结构。以 OpenCode 为例最终路径必须是~/.opencode/skills/obsidian-skills/skills/模块名/SKILL.md只复制内部文件夹就不满足要求。随后重启代理让代理写一条带 callout 的笔记来验证。Bases 表格报 YAML 错误最常见两种——公式里含双引号时外层要改用单引号两个日期相减得到的是 Duration不能直接取整要先取.days再处理。obsidian-bases/SKILL.md 的 Troubleshooting 一节有对照示例可直接把报错内容贴给代理让它修正。CLI 命令没反应obsidian命令依赖一个正在运行的 Obsidian 实例先确认 Obsidian 已打开多库同时打开时在命令里加vault库名指定目标。下一步做什么别急着搭完整体系今天只做一件事建一篇“项目战略”笔记加上status和due两个属性让代理生成一张按这两个属性过滤的任务 base 表在 Obsidian 里打开确认笔记出现在表里。这一步通了后面的画布、复盘和自动化都只是在同一套属性上继续扩展。【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考