Community程式設計與開發github.com

BorjaGM1/kb-模板

對知識庫進行清理與整理(處理中斷連結、孤立筆記、重複內容、陳舊筆記、標籤及主題地圖),並生成報告。刪除操作需經擁有者同意。

kb-模板 是什麼?

此技能專為管理以 Markdown 為基礎的知識庫而設計,能自動檢測並修復常見的維護問題,如中斷連結、孤立筆記、重複內容、陳舊筆記、混亂標籤及過時的主題地圖(MOC)。它支援對多個知識庫進行批次掃描,並產生詳細報告,列出已修復內容及需要使用者確認的提案(如合併或刪除)。技能會尊重使用者決策,不會未經確認就刪除任何筆記。此技能主要適用於本地命令列環境,通過 Python 指令碼執行,並與 Git 工作流程整合,確保每次變更都進行提交。對維護大型個人知識庫的使用者來說,這項技能能顯著減少手動清理的負擔,保持其連結結構的健康與一致性。

相容平台~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. 中斷連結:透過指向現有筆記來修正錯字/重新命名;如果目標確實遺失,僅在有用時才建立 stub,否則取消連結。切勿虛構內容。
  4. 孤立筆記:將每個孤立筆記從相關筆記或 MOC 建立連結;若不適合,則移至 Inbox/。
  5. 重複內容:使用 rg 比對相似標題/別名/內容。將其合併到較佳的筆記(保留所有事實、來源的聯集、新增別名、重新導向連結)。會移除內容或檔案的合併:提出提案,而非直接執行。
  6. 陳舊筆記:updated 超過 6 個月、空的 stub、已完成的專案:提議 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.

相關技能