ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Obsidian-skills 新手贡献指南

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 是专为 Obsidian 设计的 AI 代理技能集教会 AI 代理直接创建和编辑库里的 Markdown、Bases、JSON Canvas 文件。本文是一份开源贡献指南面向没有相关经验的开发者解决两件事找到适合你的切入点以及从克隆仓库到 PR 合并每一步要敲什么。这是什么项目为什么你能上手整个仓库是纯 Markdown没有构建、没有依赖安装、也没有要搭的测试环境门槛就是会写 Markdown。每个技能是一个独立目录根部的 SKILL.md 告诉代理该文件类型该怎么处理references/ 子目录放细节参考文档按需出现。obsidian-skills/ ├── skills/ │ ├── obsidian-markdown/SKILL.md │ ├── obsidian-bases/SKILL.md │ └── json-canvas/SKILL.md └── README.md所有技能以 MIT 许可证开放任何兼容 Agent Skills 规范的代理都能直接使用。你能写 SKILL.md 就能开始不需要熟悉任何 AI 框架。按你的角色挑一个切入点切入方向有四种选贴合你日常的那一种从单个任务做起。写文档的人给 obsidian-bases 补进阶教程现有 SKILL.md 覆盖了 .base 工作流但视图组合、公式用法和实际例子还可以整理成新的参考文档。把五个技能的 SKILL.md 翻译成中文放进对应 skills/ 子目录。造技能的人开发流程是四步确认需求、写 SKILL.md、附示例、自测代理输出。比如想做 obsidian-templates 让代理生成并维护模板文件先对照现有 SKILL.md 的结构再新建 skills/obsidian-templates/ 目录。修问题的人校对 obsidian-bases 里的 YAML 示例和公式说明修正表述不一致的地方。检查各 SKILL.md 与示例文档之间的相对链接修掉失效的引用。传经验的人写一篇「让 AI 代理操作 Obsidian 库」的实战博客或在社区活动中做分享。这个项目缺中文的实操记录你写下的每一步都有用。从 Fork 到合并你要敲的命令这一节讲从 Fork 到合并的完整路径五步git 命令只有三条。Fork在仓库页面创建你自己的副本。clone把代码拉取到本地。建分支按改动内容命名比如 fix/markdown-typo。开发测试改文件在本地 Obsidian 库中验证代理输出。push 后到 fork 页面发起 PR。git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills cd obsidian-skills git checkout -b fix/markdown-typo git push origin fix/markdown-typo注意事项提交信息用英文、遵循 Conventional Commits例如docs: fix callout syntax in obsidian-markdown或feat: add templates skill。改动技能时SKILL.md 的 frontmattername、description必须完整字段缺失会导致代理无法触发该技能。修 bug 先找到对应的 Issue在 PR 描述里写上编号。新人前 72 小时做什么三步动作先通读 Agent Skills 规范和一两个技能的 SKILL.md弄清一个技能长什么样再领一个 Issues 里标了 good-first-issue 的任务先在下面留言认领再动手最后在项目的讨论区介绍自己说明想贡献的方向。沟通渠道各一句话Issues 报 bug 和提功能建议讨论区做技术交流和 PR 前的讨论响应慢时可以直接邮件维护者。行为准则只有两条对所有贡献者一视同仁给意见时指向具体修改点不做主观评判。你从贡献中带走什么你会获得 AI 代理技能开发能力规范公开练习场就在这个仓库里。你会攒下一份可追溯的社区贡献记录写进简历时它比课程证书更有说服力。你还会看清项目的路线图方向知道后续精力该投在哪个技能上。仓库体量小、文件少每个 PR 都能快速看到结果。挑一个贴合你的角色从小任务开始提交第一个 PR。这个项目的目标是让 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表