Community生產力與協作github.com

goromal/agent-skills

整合、分類、整理或歸檔來自指定 Notion 頁面的 ITNS(「將這些筆記整合到某處」)筆記到適當的子頁面。當使用者提及 ITNS、要求處理 Notion 筆記存放庫或命名一個需要歸檔零散筆記的頁面時使用。

agent-skills 是什麼?

這個技能提供了一個自動化工作流程,用於處理 Notion 中未分類的 ITNS(「將這些筆記整合到某處」)筆記。它透過比對 `~/configs/goromail-categories.csv` 設定檔來解析來源頁面,並使用 Notion MCP 伺服器來探索子頁面目標,然後遞迴地列出區塊以辨識獨立的筆記樹。此技能會根據語義相似度自動移動明確的筆記,但對於任何模糊的歸類、新子頁面建立或邊界不明確的情況,一律要求使用者確認,從而確保準確性。從技術上講,它依賴於 Notion MCP 伺服器的功能(例如 `notion_move_block` 和 `notion_move_blocks`),並在每次批次操作後執行嚴格的驗證,以確保資料完整性。支援 Claude Code、Coder 等相容平台,透過清晰的自動化和人工決策點組合,有效地組織大型 Notion 存放庫,非常適合需要保持筆記系統井然有序的使用者。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/itns-notes

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

處理 ITNS 筆記

使用已安裝的 Notion MCP 伺服器。保留每則筆記的文字、格式、連結、日期、優先標記、區塊類型、順序及巢狀子項目。除非使用者明確要求,否則不要摘要、改寫、分割、合併、去重或刪除內容。

解析來源頁面

  1. 將使用者提供的頁面名稱與 ~/configs/goromail-categories.csv 的第一欄進行精確且不分大小寫的比對。
  2. 使用對應的第二欄 Notion 頁面 ID。
  3. 若無完全相符或有多筆完全相符,則停止並詢問。切勿根據相似名稱猜測 ID。

探索筆記與目標

  1. 在來源頁面上呼叫 notion_list_subpages 以收集候選目標。
  2. 在來源頁面上以 recursive: true 參數呼叫 notion_list_blocks。將一個父區塊及其所有後代視為一個不可分割的筆記樹。
  3. 當相鄰的頂層段落、列表項目、程式碼區塊及其他散文內容明顯形成連續的思路時,將其視為一個複合筆記。若其邊界不確定,則將該邊界歸類為模糊並詢問使用者。
  4. 排除標題、子頁面區塊、頁面提及連結及其他導航或結構性區塊。當存在 Repository 標題時,將其後的零散內容作為來源筆記區域。若無可靠的來源筆記邊界,請在移動任何內容前詢問。
  5. 透過遞迴區塊列表檢查相關目標內容。應同時根據目標標題和其既有的主題(而非僅標題)進行分類。
  6. 對於不透明的連結或模糊的標籤,在可存取時檢查連結的資料。若其主題仍不明確,應詢問而非推斷。

自動決定或詢問

僅在下列所有條件皆成立時,才自動移動筆記:

  • 恰好有一個現有的子頁面具有強烈的語義契合度;
  • 已理解完整的筆記及其邊界;
  • 此移動不需要改寫、分割、合併或發明新的分類。

將所有其他情況視為模糊。提供完整的筆記或忠實的簡潔預覽、可能的目標,以及一個附有簡短理由的建議。在寫入該筆記前等待使用者決定。在建立或命名新子頁面之前務必詢問。

在等待模糊筆記決定的同時,繼續處理獨立且明確的筆記。不要讓一個明確的歸類默默地決定相關的模糊歸類。

執行並驗證移動

  • 使用 notion_move_block 移動一個頂層筆記樹;其後代會隨之移動。
  • 使用 notion_move_blocks 移動由相鄰頂層區塊組成的複合筆記。一次將區塊 ID 以其原始順序傳遞到一個目標。
  • 使用 notion_create_subpage 建立使用者核准的分類,然後僅移動已核准的筆記。
  • 切勿使用有損的文字附加加刪除來模擬移動。
  • 每次批次操作後,重新列出來源和目標。驗證每個來源區塊已不存在,每個目標區塊按順序存在,子計數相符,且區塊類型和文字均保留。
  • 若任何操作部分失敗,請停止進一步寫入,檢查兩個頁面,並在嘗試修復前報告確切的已複製、已封存、剩餘或重複的區塊。
  • 若遞迴列表或有序批次移動不可用,請停止並報告必須先部署或升級 Notion MCP 伺服器,才能安全處理複合筆記。

最後提供自動移動、使用者核准移動、已建立頁面、延遲模糊項目及驗證結果的簡明記錄。

Individual skills in this repo

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

相關技能