Community程式設計與開發github.com

BorjaGM1/kb-template

將擁有者發送的內容(文字、連結、語音備忘錄轉錄、螢幕截圖)轉換為格式良好、相互連結的筆記,並存放於正確的知識庫中。

kb-template 是什麼?

此技能(Capture)旨在將來自使用者的各種輸入(文字、連結、語音筆記、螢幕截圖、長串討論串)自動化地轉換為結構化且相互關聯的筆記。它會先檢查輸入範圍、提取內容(例如對長串討論串進行全文閱讀,並註明覆蓋範圍)、選擇正確的知識庫(vault)進行存放。工具會搜尋現有筆記以避免重複,優先更新既有筆記。若需建立新筆記,會遵循原子化原則(一則筆記一個想法),並自動補上前置資料(created/updated/source/tags)及至少一個雙鏈接([[link]]),同時將筆記新增至對應的MOC或Home.md。此技能支援多種AI代理平台(如Claude Code),並在操作結束前執行語法檢查(lint)與自動提交,確保品質與版本控制。

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

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Capture

  1. 從專案根目錄執行:git pull --rebase。
  2. 檢查範圍(AGENTS.md):是否明確發送?是否為排除的主題?移除任何機密資訊。
  3. 提取內容:
    • 文字:直接使用,修飾措辭,保留原意。
    • 連結:擷取頁面;記錄標題、作者、日期、3-7 個重點,以及在 source 中放入網址。
    • 語音:轉錄;保留擁有者的意圖;刪除填充詞。
    • 長串討論串(X、論壇):閱讀完整的回覆文字,而非截斷的片段,且不限於第一頁。對於極長的討論串,應涵蓋實質主體(作者回覆、高訊號回覆)。在筆記中說明覆蓋範圍(例如「已閱讀 55 則作者回覆中的 40 則」)。
    • 螢幕截圖/圖片:描述/OCR 相關文字;若有需要,將圖片儲存於 attachments/。
  4. 選擇知識庫(AGENTS.md 中的表格)。若不確定:預設知識庫 Inbox/ 加上一個問題給擁有者。
  5. 搜尋相同主題的現有筆記(rg -il "<keywords>" vaults/<v>)。優先更新現有筆記(更新 updated 欄位),而非建立重複筆記。
  6. 若為新筆記:每個想法一個原子筆記;若輸入涵蓋多個想法則拆分。檔案名稱依 AGENTS.md 規範;前置資料包含 created/updated/source/tags;內容與標籤使用英文。
  7. 建立連結:至少一個 [[link]] 連接到相關筆記或 MOC,並將其加入對應的 MOC(或 Home.md)。未分類的筆記放入 Inbox/。
  8. 絕不虛構;推測需標註。
  9. 提交前審查: 將草稿筆記與相關/已連結的筆記,以及知識庫的現有標籤(rg -h '^tags:' vaults/<v> | tr -d '[]' | tr ',' '\n' | sed 's/^ *//' | sort -u)並列重讀。檢查並修正:
    • 內文與標籤使用英文。
    • 標籤符合主題,並與相關/已連結的筆記一致。
    • 優先重用現有標籤,而非發明新標籤。
    • Wiki 連結以及 MOC / Home.md 的條目齊全。
    • 沒有虛構的事實;推測已標註。
  10. 執行 python3 scripts/lint.py vaults/<v>;提交 capture(<v>): <title>;立即推送。
  11. 簡短回覆所建立/更新的筆記。

Individual skills in this repo

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

相關技能