Community编程与开发github.com

BorjaGM1/kb-template

对知识库进行清理和整理(修复失效链接、孤立笔记、重复内容、过时笔记、标签和MOC),并生成报告。删除操作需要获得所有者许可。

kb-template 是什么?

该技能是一个用于维护和管理个人知识库(Vault)的自动化工具集,它通过一系列脚本(如lint.py)来检查并修复知识库中的常见问题,确保笔记的链接、结构、元数据和标签的整洁有序。技能支持所有知识库,并提供详细的修改报告,其中包含需要用户确认的潜在破坏性操作(如合并、归档或删除)。它特别适合使用Obsidian等双链笔记工具的用户,能高效地降低知识库混乱,提升信息检索和长期维护效率。所有操作均需用户最终确认,确保安全。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorjaGM1/kb-template/tree/HEAD/skills/gardening

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

园艺

  1. 从仓库根目录执行:git pull --rebase。
  2. 运行 python3 scripts/lint.py(所有知识库)并收集输出。
  3. 失效链接:通过纠正拼写/重命名指向现有笔记;如果目标确实丢失,仅在有用时创建存根,否则取消链接。切勿编造内容。
  4. 孤立笔记:将每个孤立笔记从相关笔记或MOC中链接;若无法连接,则移动到 Inbox/。
  5. 重复内容:查找相似的标题/别名/内容(rg,比较)。合并到较好的笔记中(保留所有事实,合并来源,添加别名,重定向链接)。涉及删除内容或文件的合并:提出建议,不要执行。
  6. 过时笔记:updated 超过6个月、空存根、已完成的项目:建议添加 status: archived 或删除。
  7. 标签:统一大小写/kebab-case,合并同义词(#ideas 合并到 #idea),移除一次性噪声标签。
  8. 元数据:确保 created/updated/source/tags 存在且有效。
  9. 收件箱:当内容明确时,将 Inbox/ 中的笔记归档到正确位置。
  10. MOC:保持 Home.md 和主题MOC最新;当某个主题达到约5条笔记时,创建一个MOC。
  11. 重新运行lint;按逻辑变更提交(garden(<v>): ...);每次提交后立即推送。
  12. 报告 给所有者:说明已修复的内容,以及待批准的删除/合并/归档建议。未经所有者同意,不得删除任何内容。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相关技能