企业官网建设流程全解析

1 行命令装好 obsidian-skills：教 AI 读写 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

obsidian-skills 是一套开源 Agent 技能包，让 Claude Code、Codex 等 AI 助手学会读写 Obsidian 笔记、Bases 数据库与 Canvas 画布，解决 AI 不懂 Obsidian 私有语法、容易改坏知识库的问题。

🧭 明确项目定位：给 AI 一份 Obsidian 操作手册

obsidian-skills 不是插件，而是一组遵循 Agent Skills 规范的技能文件，任何兼容该规范的客户端都能加载。机制很直接：每个技能由一份 SKILL.md 主文件和若干参考文档组成，AI 接到任务后照着文件里的语法规则和工作流操作 Vault。说白了，它把 wikilinks、callouts、frontmatter 这些 Obsidian 私有写法，写成模型能直接执行的说明书。

📥 对号入座：三类知识库任务可以直接交给 AI

批量补全笔记元数据。一百多条会议纪要缺 frontmatter、缺标签、彼此不链接。让 AI 给每篇统一加 title、tags、status，再用 wikilinks 把相关会议串起来——规则明确、重复度高的活最适合外包。

把散落笔记变成数据库。读书笔记散在十几个文件里，你想按状态筛选、按来源分组。AI 可以生成 .base 数据库文件，做出表格和卡片两种视图，还能用公式算出阅读进度。

网页进库并建图谱。收藏的文章要先清洗再入库：用 Defuddle 提取干净正文存成笔记，再把关键概念画进 Canvas 关系图。

拆解核心能力：笔记语法、数据库、画布与命令行

用 AI 写对 Obsidian 风味 Markdown

obsidian-markdown 技能覆盖 wikilinks、嵌入、callouts、属性、标签等私有语法，并规定库内链接用 [[wikilink]]、外部 URL 才用普通链接。一个例子：批量给新建笔记套用属性模板，属性类型规则见 skills/obsidian-markdown/references/PROPERTIES.md。另一个是修复断链：AI 先定位引用位置，再重建指向。

配套的 defuddle 技能做网页清洗：defuddle parse <url> --md -o content.md一行命令去掉导航和广告，只留正文，省 token 也省时间。

用 Bases 给笔记建可筛选的数据库视图

obsidian-bases 技能让 AI 会写 .base 文件：filters 圈定范围，formulas 定义计算属性，views 输出 table、cards、list、map 四种视图。例子：给阅读清单建库，用status == "reading"过滤出在读书目，表格视图按来源分组。函数语法查 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。

用 JSON Canvas 画知识关系图谱

json-canvas 技能处理 .canvas 文件：每个节点生成 16 位十六进制 ID，连线必须引用已存在的节点，新增节点还要避开重叠位置。例子：把一篇读书笔记里的几个概念画成关系图，AI 建完会校验 ID 唯一性和连线完整性。样例见 skills/json-canvas/references/EXAMPLES.md。

用 Obsidian CLI 批量操作 Vault

obsidian-cli 技能教 AI 驱动运行中的 Obsidian：读笔记、追加内容、改属性、查任务。例子：obsidian property:set name="status" value="done" file="X"一条命令更新笔记状态，配合模板参数还能批量建笔记。前提是 Obsidian 处于打开状态。

🚀 从 0 到跑通：一行命令完成安装与首次调用

第一步，安装：

npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills

支持插件市场的客户端，也可以用/plugin marketplace add kepano/obsidian-skills加/plugin install obsidian@obsidian-skills两条斜杠命令完成。

第二步，客户端要求手动放置时，按官方说明放对目录：Claude Code 拷到 Vault 根目录的 .claude 文件夹，Codex 把 skills/ 目录拷进 ~/.codex/skills，OpenCode 必须克隆整仓，只拷内层 skills/ 文件夹会失败：

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

第三步，重启客户端，先下一个小任务试试，比如"给这篇会议笔记加 frontmatter 属性并链到相关笔记"，跑通后再加大任务量。

⚠️ 排查 obsidian-skills 常见失效问题

技能没生效，AI 仍写标准 Markdown。客户端不兼容 Agent Skills 规范，或装完没重启。解决：确认所用客户端在支持列表里，重启一次再试。

OpenCode 里技能完全不被发现。原因是只复制了内层 skills/ 文件夹。解决：OpenCode 要求整仓克隆，最终目录必须是~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md。

AI 把 wikilink 写成普通链接，像没触发技能。技能靠指令关键词触发。解决：指令里带上"Obsidian 笔记、wikilinks、callouts、frontmatter"这类词。

obsidian CLI 命令报错或无反应。CLI 技能操作的是运行中的 Obsidian 实例，默认指向最近聚焦的 Vault。解决：先打开 Obsidian，多库环境把vault="My Vault"作为第一个参数。

.base 文件打开报 YAML 错误。常见于带特殊字符的字符串没加引号，或引用了未定义的formula.X。解决：按技能内校验清单检查引号与公式定义，再让 AI 修正。

进阶玩法：建阅读数据库与跑插件调试闭环

给读书笔记建完整数据库。思路分两步：先让 AI 用 markdown 技能批量给笔记补 status、source、开始日期三个属性，再生成 .base——全局过滤掉已归档的，表格视图按 source 分组看进度，卡片视图只显示在读的书。之后每周说一句"刷新阅读库视图"，AI 基于新属性更新即可，不必重建文件。

用 CLI 技能跑插件开发闭环。改完插件代码，让 AI 依次执行obsidian plugin:reload id=my-plugin重载、obsidian dev:errors查错、obsidian dev:screenshot path=screenshot.png截图验证；有错就修完再重载。这个循环替代手动"改—刷新—观察"，插件和主题开发都适用。

找到下一步资料：从仓库文档入手

这套技能包适合已有 Vault、日常使用 Claude Code 或 Codex 等 AI 客户端的知识工作者。各技能的完整语法以仓库内各 SKILL.md 与 references 目录为准，安装方式与目录结构如有变化，以仓库最新 README 为准。

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