
Obsidian-skills 测试用例速查覆盖 Markdown、Bases、JSON Canvas 五大技能发布前快速避坑【免费下载链接】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 让 AI 代理处理 Obsidian Markdown、Bases、JSON Canvas 三种开放格式并用 Obsidian CLI 操作 vault。本文讲清 5 个技能的测试用例怎么写、测试环境怎么搭、发布前逐项查什么。 先写一条用例输入 → 预期 → 验证 三要素别急着跑东西先用三要素格式把一条用例写下来写不出这三条的用例只是猜测。每个技能、每种场景都套这个模板测试就能积累成清单。输入喂给技能的内容比如让代理生成一段带特定语法的笔记预期输出应该长什么样说清楚可判定的标准而不是看起来对验证方式怎么确认打开 Obsidian 看渲染、解析 JSON 检查字段、或看命令返回值举个 obsidian-markdown 的例子输入让代理新建一条笔记内容里引用已存在的[[会议纪要]]预期链接被识别为内部链接且目标笔记真实存在于 vault 里验证在 Obsidian 阅读视图点这条链接能跳到目标笔记就通过点出来是一个空白新笔记说明目标不存在判失败 技能关注点对照表五行看完五大技能的测试范围先对照这张表圈出重点拿不准细节再去对应技能文件里查完整说明不用凭印象写用例。技能路径核心测试点高频翻车点obsidian-markdownskills/obsidian-markdown/SKILL.md维基链接、callout、frontmatter、嵌入在预览里都渲染正确frontmatter 特殊字符弄坏 YAML链接目标笔记不存在obsidian-basesskills/obsidian-bases/SKILL.mdfilter 结果对、formula 算得对、summary 数值对四种视图都能显示公式引号不匹配Duration 直接调.round()引用了没定义的formula.Xjson-canvasskills/json-canvas/SKILL.md节点 ID 唯一、边引用真实节点、尺寸和间距合理fromNode指向不存在的 ID换行写成字面\\nobsidian-cliskills/obsidian-cli/SKILL.mdread/create/append、search、property:set、tasks能正常执行Obsidian 没开着导致命令失败含空格的参数值没加引号defuddleskills/defuddle/SKILL.md--md输出干净、-p元数据提取准、存文件正常工具没安装.md链接不该走 defuddle 3 步搭好测试 vault 和测试数据第 1 步把技能拉到代理能找到的目录clone 下来即可代理会自动加载里面的技能文件。git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills第 2 步单独建一个测试 vault别拿真实笔记库练手。里面备三类料几张带齐维基链接、callout、标签、公式、脚注的 .md 笔记一个带属性和公式的 .base一个带多种节点和边的 .canvas。以后所有用例都往这个 vault 里跑结果可复现、数据不脏。第 3 步装依赖并让 Obsidian 保持运行。defuddle 用 npm 全局安装同时把测试 vault 在 Obsidian 里打开CLI 类用例全靠这个前置条件。npm install -g defuddle⏱ 执行节奏开发中、提交前、发布前各跑什么按下面三个节奏跑测试平时快、关键节点全开发中改一处只跑该技能的校验比如解析一遍 YAML 或 JSON、预览渲染一次别每次都跑全套提交前用最小用例集把五个技能各跑一遍只确认还能用发布前补边界条件空输入、特殊字符、长文本、节点多的画布再跑一条端到端流程网页用 defuddle 提取 → 写成笔记 → 用 Bases 汇总 → 用 Canvas 画关系图⚠️ 避坑速查5 个常见失败现象和处理办法现象可能原因处理办法Canvas 文件打不开JSON 解析报错text 节点里的换行或引号没转义换行统一写\n写回文件前先解析验证一遍Bases 文件报 YAML 错误含:、#的字符串没加引号或公式里引号不匹配整条公式用单引号包住特殊字符字符串用双引号Bases 公式报错或算出来是 0两个日期相减得到 Duration 不是数字先取.days字段再做数值运算CLI 命令没反应或操作了错误的库Obsidian 没开着或同时开多个 vault先打开 Obsidian用vault参数明确指定defuddle 输出仍带导航、或提示找不到命令没安装全局工具或把 .md 链接传了进去先全局安装.md 链接直接读文件不走 defuddle✅ 发布前自查逐项打勾再交付每条用例都写全了「输入 → 预期 → 验证」三要素Markdown 用例frontmatter 能解析成合法 YAML维基链接目标全部存在Bases 用例文件是合法 YAMLorder引用的每个formula.X都在formulas里定义过Canvas 用例节点和边 ID 无重复fromNode/toNode全部指向真实节点CLI 用例全部在 Obsidian 运行时执行过含空格的参数值都加了引号defuddle 用例输出没有导航和广告残留title、description 能正常提取端到端流程完整跑通一次网页提取 → 写入笔记 → Bases 汇总 → Canvas 出图【免费下载链接】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),仅供参考