Notion 技能庫 是做什麼的？
讓每個受管理的技能易於發現、可安全更新，並在需要它的代理程式中可供使用。將 Notion 技能頁面視為可執行的知識產品，而非書籤或庫存列。
選擇管理模型
- 偏好使用原生的 Notion 技能資料庫來存放 Notion Agent 應能發現、執行、分享及下載到本地代理的指令。
- 對於混合資產（例如提示詞、MCP、連接器/應用程式及工作流程記錄），使用通用能力目錄，這些並非全部是可執行的 Notion 技能。
- 將內容的規範來源與目錄記錄分開。內容的權威版本可能在 Notion、儲存庫或本地來源。當兩種管理模型都存在時，能力目錄會連結到原生技能記錄或其規範來源；它不會保留第二份指令本體。
請參閱 references/native-notion-library.md 以了解如何建立、轉換、分享、啟用、下載或移除原生 Notion 技能。參閱 references/schema-and-retrieval.md 以了解如何建立新資料庫、進行綱要映射或檢索設計。
在寫入前先確認目標
- 確認已存在授權的 Notion 存取表面：已連接的 Notion 工具、一個 API 或
ntn工作階段，或已驗證的可控瀏覽器。技能本身不會授予工作區存取權。如果沒有，請要求使用者先連接一個再嘗試讀取或寫入。 - 使用使用者提供的資料庫或技能頁面。否則，在提出使用其他資料庫之前，先透過 Notion 庫或工作區搜尋來尋找工作區中現存的技能資料庫。
- 當同一群組使用與維護這些技能時，從一個共享的技能資料庫開始。只有在存取權限、擁有者不同，或需要一個完全私密的草稿空間時才拆分。
- 在建立或更新記錄之前，先擷取即時資料來源的綱要。將屬性角色映射到實際名稱，而非假設為英文標籤。
- 當存在穩定的來源或套件金鑰時，以它進行查詢。僅透過標題比對只是一個候選方案：在更新前應先比對來源、描述或本體。如果身份仍然不明確，請保持記錄分開或詢問使用者。
核心工作流程
新增或匯入技能
判斷規範來源是 Notion、儲存庫還是本地技能資料夾。擷取技能的名稱、描述、指令與支援檔案。建立或更新一個技能頁面，其中應包含：
- 一個清晰的描述，說明該技能的功能及其適用情境；
- 頁面本體中簡潔可執行的指令；
- 在必要時，將參考資料、範例、腳本、圖片或資料存放在檔案中；
- 只有當其有助於維護時，才記錄來源和所有權屬性。
請參閱 references/import-and-sync.md 了解特定來源的匯入、精確來源保留及同步規則。
新增或更新目錄中的能力
對於提示詞、MCP 伺服器、連接器/應用程式、工作流程或非原生技能記錄：
- 擷取混合目錄的即時綱要，並將名稱、資產類型、描述、規範來源/本體、檢索詞彙、需求與限制，映射到實際存在的屬性或頁面本體。
- 透過穩定的來源/套件金鑰進行重複資料刪除，然後根據記錄內容確認身份。每個能力身份建立一筆記錄。
- 將簡短的可篩選後設資料放在屬性中，將長篇的可重複使用內容放在頁面本體或附加的精確來源檔案中。沒有儲存庫的提示詞本身即可作為有效的規範本體。
- 更新時，先變更所選的內容來源，然後僅重新整理其衍生的目錄表示。保留不相關的屬性。
請勿將原生的啟用、下載、取消標記為技能或共享技能刪除語義應用於提示詞、MCP、連接器/應用程式或工作流程記錄。刪除其中一項只是普通的目錄記錄刪除，除非工作區定義了獨立的連結生命週期。
尋找並使用技能
根據使用者的預期任務、別名及可能的動詞進行搜尋——而不僅是資產名稱。在使用具語義的 Notion 搜尋介面時，優先比對描述和本體，而非僅依靠標籤。僅使用 API/CLI 時，使用標題搜尋來定位資料來源，查詢類型化描述、搜尋詞、資產類型或標籤屬性來篩選記錄，然後擷取候選本體。在執行前，先取得所選頁面及其所需的檔案。如果有多個能力符合，請根據結果或範圍區分它們，並僅在選擇會實質改變結果時才詢問使用者。
更新技能
更新規範來源，然後重新整理衍生的副本。保持描述與當前行為一致，因為 Notion Agent 會用它進行自動選擇。保留不相關的屬性與檔案。僅當附件來源變更時才進行更換；除非有正當理由，否則不要累積編號副本。
分發或移除技能
對於本地代理使用，當原生技能頁面是內容的規範來源時，偏好使用 Notion 的下載到本地代理流程。對於儲存庫規範的技能，在確認目標代理支援打包的 Agent Skills 結構後，使用該代理文件說明的技能安裝機制；將 Notion 頁面保留為其可發現的表示。
區分移除動作：刪除頁面會為所有人移除共享技能；停用已發現的技能僅影響目前使用者；取消標記會保留一個普通頁面；而解除安裝本地副本不會刪除其在 Notion 的來源。刪除 Notion 頁面不會移除已下載到本地代理的副本；請分別解除安裝它們。切勿以一個動作取代另一個。
品質契約
在將共享技能標記為就緒之前：
- 其描述必須夠具體以便自動選取，同時又不會吸引到不相關的任務；
- 其本體須說明成果、必要的輸入、影響決策的限制，以及預期的輸出或完成條件；
- 可選的細節移至參考資料，而必要的指令則保留在頁面中；
- 精確來源與可執行檔案在選擇的 Notion 表示中得以完好保存；
- 至少已完整走過一個實際請求，足以暴露出缺少的輸入、錯誤的路由或無法使用的輸出；
- 共享技能有明確的維護者，無論該資訊是否儲存為「擁有者」屬性。
請參閱 references/quality-playbook.md 了解如何建立新的共享技能、進行大幅修訂，或為公開推薦做準備。
不要將「未驗證」或「未採用」作為預設閘門。僅當真實的團隊工作流程會使用其值時，才新增生命週期欄位。儲存驗證方法或機密位置，切勿儲存機密值。
工具路由
使用已連接的 Notion 工具進行語義搜尋、頁面讀取及一般頁面更新。使用目前的 Notion API 或 ntn 進行即時綱要、類型化屬性查詢、分頁、檔案與不支援的欄位。使用瀏覽器互動來處理僅在 Notion UI 中暴露的原生技能庫控制項。發現目前的工具語法，不要猜測；一旦目前的存取表面報告某工具不可用，就停止重試。API/CLI 工具可以建立一般資料庫，但無法將其標記為原生技能資料庫。如果瀏覽器控制項不可用，請向使用者提供文件所述的 UI 轉換步驟，並等待他們完成後，再繼續進行原生綱要或內容相關工作。