企业官网建设流程全解析

让 AI 写笔记、查数据、画图：obsidian-skills 5 个技能快速上手指南

【免费下载链接】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

obsidian-skills 是面向 Obsidian 的一组 Agent Skills，让 Claude Code、Codex、OpenCode 等 AI 助手直接创建和编辑 Obsidian 风格 Markdown、Bases 数据库视图与 JSON Canvas，适合想让 AI 代管笔记库的 Obsidian 用户和插件开发者。

为什么 AI 总把 Obsidian 语法写错

让 AI 助手往你的库建笔记时，它默认只会标准 Markdown：[[笔记名]]维基链接、![[图片]]嵌入、> [!tip]标注框、.base视图文件，这些它都不认识，产出的文件轻则语法报错，重则和你库里的内容对不上。obsidian-skills 的做法是把 Obsidian 各文件格式的规则打包成 5 个标准技能，agent 读完就能写出格式正确的文件。技能遵循 Agent Skills 规范，所以 Claude Code、Codex、OpenCode 都能用。

5 个技能能做什么：归成三组看

📝 内容创作：写对格式的笔记与画布

obsidian-markdown 覆盖 Obsidian 对 Markdown 的全部扩展：维基链接（含[[笔记#标题]]这类指向标题和块的写法）、嵌入、标注框、YAML 属性、%%注释%%与==高亮==等，配套的 PROPERTIES.md、EMBEDS.md 让 AI 知道每种语法的正确写法。json-canvas 负责.canvas文件：text、file、link、group 四种节点和连线，连节点 ID 生成和坐标间距都有约定，适合让 AI 直接把思维导图、流程图画进库里，完整示例见 EXAMPLES.md。

🗂️ 数据整理：把笔记当数据库查

如果你的笔记已经带上 status、due、priority 这类属性，obsidian-bases 就能在它们之上生成.base视图：and/or/not 组合过滤、公式计算、table、cards、list、map 四种视图类型。全部函数签名在 FUNCTIONS_REFERENCE.md 里，任务管理、书单、文献库这类场景基本都靠它。

⚙️ 自动化操作：命令行管库，网页内容进库

obsidian-cli 让 AI 直接操作正在运行的 Obsidian 实例：创建、追加、搜索、改属性、查反向链接，比如obsidian search query="tag:todo"一条命令出结果；做插件和主题开发时还有重载、报错检查、截图、DOM 检查等开发命令。defuddle 用 Defuddle CLI（defuddle parse <url> --md）把网页剥掉导航、广告等噪音转成干净 Markdown，省 token，也避免把整页 HTML 塞进上下文。

三种平台的安装方式与验证清单

Claude Code：把仓库内容放进 Obsidian 库根目录的/.claude文件夹。Codex：把skills/目录复制到 Codex 技能路径，通常是~/.codex/skills。OpenCode：克隆整个仓库，注意不能只拷内层skills/文件夹：

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills

OpenCode 会自动发现~/.opencode/skills/下的所有 SKILL.md，不用改任何配置，重启后生效。README 里还列了/plugin marketplace add和npx skills add两种通用装法，按你的平台选。

装完按四步验证：

1. 重启 AI 助手
2. 让它建一条带维基链接和标注框的笔记，在 Obsidian 阅读视图里打开确认渲染正常
3. 让它写一个简单的.base文件（一条过滤条件即可），确认视图能显示
4. 要用 obsidian-cli 就先打开 Obsidian，再试obsidian search query="test"

两个贴近日常的任务走查

让 AI 搭一个任务看板

目标：把库里所有#task标签的笔记拉出来，能查状态、能看剩几天到期。操作：告诉 AI"基于 task 标签的笔记建一个 Bases 视图，要显示距到期还有几天"，它会引用你笔记里的 due 属性写出公式：

formulas: days_until_due: 'if(due, (date(due) - today()).days, "")'

再配上表格视图：过滤掉已完成项、按状态分组。得到的结果是一个.base文件，未完成和已完成各占一个视图，"距到期天数"一列自动算好，之后你只管维护笔记，视图不用碰。

把网页内容收进库做成卡片

目标：把一篇在线文章整理成可检索、可链接的文献卡。操作：先让 AI 跑defuddle parse <url> --md拿干净正文（CLI 没装的话先npm install -g defuddle），再按 obsidian-markdown 的规范写笔记：顶部加 title、tags、aliases 属性，正文关联已有笔记的维基链接，开头放一个> [!summary]标注框写摘要。得到的是一张能进 Bases 视图、能被搜索命中的卡片，全程不用切出对话窗口。

四个常见报错与修法

• Bases 视图报 YAML 语法错误：多半是字符串里的:等特殊字符没加引号，或公式内双引号和外层引号打架。把这类字符串加引号，公式里含双引号时整个公式改用单引号包住。
• "剩余天数"公式报错：两个日期相减得到的是 Duration 而不是数字，不能直接.round()。先取.days拿到数值再四舍五入。
• Canvas 文本里\n显示成两个字符：JSON 字符串里写了字面量\\n，改成\n；顺带确认节点和连线 ID 无重复、边没有悬空引用。
• OpenCode 检测不到技能：只拷了内层skills/文件夹导致目录结构不对。重新克隆整个仓库，确保路径是~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md。

它适合谁，从哪里开始

如果你的库里已经在打标签、建属性，又希望 AI 不只是聊天、而是真的写出能用的.md、.base、.canvas文件，这套技能值得装；做 Obsidian 插件的话，obsidian-cli 的开发命令能省掉大量手动重载和截图。新手建议先让 AI 建一条带标注框和维基链接的笔记，跑通之后再上 Bases 视图。各技能的完整规则和参考文档都在 skills/ 目录下，可按需查阅。

【免费下载链接】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