发布时间:2026/8/31 9:03:04
obsidian-skills 测试指南:从零跑通第一组用例的完整教程 obsidian-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-skillsobsidian-skills 是给 AI 代理用的 Obsidian 技能套件它教会代理怎么写 Obsidian Markdown、Bases、JSON Canvas怎么调 Obsidian CLI 和网页提取工具。这些技能本质是一组行为说明书代理照着写文件但说明书里的细节稍有一点没执行对生成的文件在 Obsidian 里就打不开。这篇 obsidian-skills 测试教程带你从空白环境开始一步步把第一组测试用例跑起来再慢慢扩展到五个技能。1️⃣ 30分钟配好环境先跑通第一条命令先 clone 仓库到本地git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills然后准备三样东西一个装着几篇真实笔记的 Obsidian 库、装好并保持打开状态的 Obsidian CLICLI 要连着一个运行中的 Obsidian 实例才能工作、以及 defuddle 命令行工具npm install -g defuddle一条命令搞定。这里容易踩坑CLI 相关的测试如果 Obsidian 没开着命令会直接失败别以为是技能写错了。建一个专门的测试库新建一个空库 TestVault往里丢三篇笔记——一篇带 frontmatter 和标签的、一篇带[[双链]]的、一篇随便写写的。后面所有用例都拿它当靶子别污染你的主力库。2️⃣ 写下你的第一个最小用例测试 obsidian-skills 有个特点技能是 SKILL.md 这样的提示文档不是可执行代码。所以跑一个用例的意思是给代理一条指令 → 让它产出文件 → 检查产出 → 拿 Obsidian 亲自打开确认。我们第一个用例就挑 JSON Canvas。给代理的指令可以是生成一个只有两个文本节点、一条边的画布。然后打开skills/json-canvas/SKILL.md按里面的清单核对产出JSON 能被正常解析最基本要求每个节点的id都是 16 位十六进制且节点和边之间没有重复每条边的fromNode/toNode都能在 nodes 里找到最后把.canvas文件丢进测试库双击打开不报错就算过最空的合法画布长这样可以作为产出的对照基线{ nodes: [], edges: [] }跑一下你会发现新手最常挂的第一条就是JSON 解析不过——多半是文本节点里的换行没写成\n而是把字面的反斜杠n 写进去了。3️⃣ 扩展覆盖五种技能各一套检查项用例通过之后就可以按文件格式把覆盖扩到其余技能。简单说每种格式记住 2~3 个最关键的检查点就够了剩下的细节各 SKILL.md 里都有现成的清单。文件类Markdown、Bases、Canvasobsidian-markdown让代理写一篇带 frontmatter、[[Note#Heading]]链接、 [!note]标注框的笔记重点看 wikilink 和嵌入语法有没有拼错然后切到阅读视图扫一眼渲染效果。obsidian-bases让代理建一个带 filters 和 formulas 的.base重点查两处——YAML 里带引号或冒号的字符串加引号了没order里引用的formula.X在formulas里真的定义了吗。再打开 Obsidian 看视图能不能渲染出来。json-canvas除了第一个用例的清单再补一条边界检查加节点时位置要和已有节点留 50~100px 间距别重叠。命令类CLI 和 Defuddle这两个不用查文件结构直接看输出obsidian-cli走一遍创建 → 读取 → 追加 → 再读取的往返流程确认create写进去的内容和read读出来的完全一致再跑一条search看看结果条数对不对。defuddle拿一篇真实博客页跑defuddle parse url --md看导航和广告有没有被剥干净再用-p title对照页面标题。注意它专门不处理.md结尾的链接别拿 markdown 源文件测它。4️⃣ 让 GitHub Actions 帮你盯回归用例攒到五六个之后每次改完 SKILL.md 都手动跑一遍就累了这时候把回归交给 CI。你不需要复杂的框架CI 里做两件事就够——一是跑一段脚本对代理产出的.canvas文件做 JSON 解析、ID 唯一性、边引用完整性这三项检查对.base文件做 YAML 解析二是检查 SKILL.md 文件本身没被改坏frontmatter 里的 name 和 description 还在。配置就写在仓库的 workflow 文件里触发器选 push 和 pull_request。具体字段名对着文档填就行这里不贴完整脚本——结构很简单一个解析检查步骤加一个报告步骤。好处是你半夜改了技能描述第二天早上 PR 里就能看到红绿。CI 挂的时候先看哪一步红基本就能定位到是哪个技能的产出格式变了。5️⃣ 踩坑排错三种最常见的翻车现场文件打不开、报语法错误九成是这两个原因。CanvasID 重复、边引用了不存在的节点、文本里换行转义写错。Bases字符串里有冒号没加引号displayName: Status: Active这种必挂、公式里引号嵌套没处理好。拿报错的文件对着 SKILL.md 里的 Troubleshooting 一节逐条排基本都能定位。渲染出来了但看着不对这类问题 CI 查不出来只能人眼过。最典型的是 Bases 里两个日期相减得到的是 Duration 而不是数字直接对它取整会报错正确姿势是先取.days再操作还有属性可能为空时没写if()兜底整列直接崩。命令跑通了但结果和预期不符先检查环境变量而不是怀疑技能Obsidian 开着没是不是最近切换过库CLI 默认操作最近聚焦的库多库场景记得加vault参数defuddle 拿到的标题为空时先确认目标页面本身有没有 title。到这里你手里应该已经有一套能跑的用例了五个技能各一两条本地手动能过CI 里自动盯着。接下来不用追求用例数量每改一版技能就把这套跑一遍哪个红了查哪个——obsidian-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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

2026/8/31 8:58:03

从零构建餐饮管理系统:全栈技术选型与高并发实践

简介:本资源是一套面向餐饮企业管理者与Java/前端开发学习者的全栈实战项目,聚焦解决门店数字化运营中的菜单管理、订单流转、员工协同与消费者点餐体验等核心问题。采用Vue.js构建响应式移动端界面,Spring Boot搭建高可用后台服务&#xff0…

2026/8/31 8:58:03

机器人何时该空翻?时机决策成为具身智能新焦点

“机器人会空翻并不稀奇”这句话放在五年前,听起来多少有点挑衅。波士顿动力 Atlas 那段后空翻视频,让很多人第一次意识到机器人可以把全身动力学玩到这种程度。到了今天,四足机器人空翻、人形机器人空翻、轮足机器人空翻,陆续出现…

2026/8/31 8:58:03

emWin模拟器SeggerEval包详解:零硬件玩转嵌入式GUI

简介:本资源为Segger官方emWin 5.16嵌入式GUI开发套件的完整Windows仿真版源码包,面向嵌入式GUI初学者、MCU应用开发者及需要快速验证界面逻辑的工程师,解决在无硬件目标板条件下开展emWin学习、调试与原型开发的核心需求。压缩包共353个文件…

2026/8/31 9:13:04

Joplin 笔记管理:五端同步,数据握在自己手里

Joplin 笔记管理:五端同步,数据握在自己手里 【免费下载链接】joplin Joplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS. 项目地址: https://gitcode.com/GitHub_Trending/jo/joplin…

2026/8/31 9:13:04

Bruno 中文使用实用指南:3 个搜索技巧快速定位 API 接口

Bruno 中文使用实用指南:3 个搜索技巧快速定位 API 接口 【免费下载链接】bruno Opensource IDE For Exploring and Testing APIs (lightweight alternative to Postman/Insomnia) 项目地址: https://gitcode.com/GitHub_Trending/br/bruno Bruno 是一款开源…

2026/8/31 9:13:04

Umi-OCR 实测:300 张照片加 536 页扫描 PDF,全程离线数字化

Umi-OCR 实测:300 张照片加 536 页扫描 PDF,全程离线数字化 【免费下载链接】Umi-OCR OCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片,PDF文档识别,排除水印/页眉页脚,扫描/生成二维…

2026/8/31 9:13:04

python的图论工业场景模拟第二十五篇:K-最短路备选规则与拥堵避让,任务:为关键物料计算3条互不重叠的备选路径,防止单一路径拥堵,图建模说明:有向带权图,nx.shortest_simple_pa

K-最短路备选规划与拥堵避让:给物料运输装上"备选导航" "AGV 调度系统里,从仓库到装配线只有一条最短路径。某天这条路上的一台辊筒线故障,所有小车堵死,产线停了 40 分钟。我后来用 "nx.shortest_simple_p…

2026/8/31 1:05:20

vSound小提琴数字处理器实操指南:从接线到演出的完整配置

电小提琴或者原声小提琴插电演出,第一个绕不开的坎就是声音难听。原声琴的共鸣和空气感一旦进了拾音器,出来的往往是一坨干瘪、发尖、带着奇怪塑料味的信号。我当初第一次把琴接上乐队调音台,直接被主唱吐槽"你这声音像在锯钢丝"。…

2026/8/31 2:14:20

传感器接口IC如何攻克生物化学传感的微弱信号难题?

1. 从电极到比特流:为什么生物化学传感必须依赖专用接口IC 做生物化学传感的人都有过类似的经历:明明传感器本身性能很好,信号输出却一塌糊涂——噪声大、漂移明显、重复性差,怎么调都达不到预期。很多时候问题并不在传感器&#…

2026/8/31 1:41:28

STM32F411CEU6多通道ADC采集:扫描模式+DMA实现详解

1. 多通道 ADC 的用武之地把“Multichannel ADC”和“STM32F411CEU6”这两个关键字放在一起,其实就是嵌入式开发里最常遇到的一类需求:用一块不算贵的 MCU,同时采集多路模拟信号。STM32F411CEU6 是 48 引脚的 Cortex-M4F 主控,主频…

2026/8/31 0:07:32

STM32C5设备支持包(IAR DFP)安装指南与常见坑

上一阵子在IAR里折腾一块基于STM32C5系列的新板子,工程从STM32CubeMX导出来之后怎么都编译不过。报错信息很干脆:找不到设备描述文件。跟着错误路径去查,发现指向的是一个让我愣了一下的名字:STMicroelectronics.stm32c5xx.2.1.0.…

2026/8/31 0:07:32

STM32N657 SWO引脚矛盾:CubeMX显示PB3,数据手册为PB5

拿到STM32N657这颗料的第一天,我就撞上了一个让人原地懵圈的引脚矛盾:CubeMX里清清楚楚显示SWO在PB3,翻开数据手册的引脚说明表,却赫然写着PB5。对于一个靠SWO输出调试日志吃饭的人而言,这种"工具和手册打架"…

2026/8/28 16:16:48

实测才敢推 AI论文网站 2026最新测评与推荐

2026年真正好用的AI论文网站,核心看生成的论文质量、低AI味、格式正确、学术适配四大指标。综合实测,千笔AI、ThouPen、豆包、DeepSeek、Grammarly 是当前最值得推荐的梯队,覆盖从免费到付费、从中文到英文、从文科到理工的全场景需求。一、综…

2026/8/28 16:16:50

2026必备!AI论文网站测评:最新推荐与深度对比

2026年真正好用的AI论文网站,核心看生成的论文质量、低AI味、格式正确、学术适配四大指标。综合实测,千笔AI、ThouPen、豆包、DeepSeek、Grammarly 是当前最值得推荐的梯队,覆盖从免费到付费、从中文到英文、从文科到理工的全场景需求。 一、…

2026/8/31 6:53:02

摆脱论文困扰!盘点2026年全网爆红的的AI论文写作工具

一天写完毕业论文在2026年已不再是天方夜谭。2026年最炸裂、实测能大幅提速的AI论文写作工具,覆盖选题构思、文献整理、内容生成、格式排版等核心场景,真正帮你高效搞定论文难题。 一、全流程王者:一站式搞定论文全链路(一天定稿首…