notion-knowledge-capture

notion-knowledge-capture 技能概覽

notion-knowledge-capture 可協助代理把對話脈絡整理成結構化的 Notion 內容，而不是把原始筆記亂塞到不對的位置。它最適合需要把 knowledge capture 這件事做好的人：判斷輸入應該變成 wiki 頁面、FAQ、操作指南、決策紀錄，還是其他可重複利用的資產。

這個技能的用途

當任務是把有用的聊天內容保存到團隊知識庫，而不只是做摘要時，就適合使用 notion-knowledge-capture 技能。它的設計目標是把決策、流程、說明與經驗教訓，以其他人日後找得到、也能重複使用的格式保存下來。

為什麼值得安裝

它的核心價值在於工作流程的紀律：會推著代理先辨識正確的內容類型，再放到對應的 Notion 位置，並透過連結或資料庫擺放維持可搜尋性。這比一般的提示詞指令更重要，因為這個技能本身已經把捕捉模式與預期結構編碼好了。

最適合的使用情境

這個技能很適合維護 Notion wiki、FAQ、決策紀錄或文件資料庫，並希望把聊天中產生的知識一致地整理進去的團隊。當來源素材是一段帶有真實營運細節的對話，而不是已經修飾好的草稿時，notion-knowledge-capture for Knowledge Base Writing 特別合適。

如何使用 notion-knowledge-capture 技能

先安裝並檢查正確的檔案

先依照你的技能工作流程完成安裝，接著先閱讀 skills/claude/knowledge-capture/SKILL.md。之後再查看範例與參考檔，了解預期的輸出樣貌：examples/conversation-to-faq.md、examples/decision-capture.md、examples/how-to-guide.md，以及 reference/*.md。

提供技能正確類型的輸入

這個技能在你同時提供對話內容與明確的捕捉意圖時表現最好，例如「把這段存成決策紀錄」或「放進團隊 wiki」。若你想要更好的 notion-knowledge-capture usage，請一併提供主題、受眾，以及頁面應該放在哪裡——如果你已經知道的話。

把模糊需求轉成可用提示詞

較弱的請求是：「存到 Notion。」
更好的說法是：「把這段部署討論整理成工程 wiki 的操作指南。請包含前置條件、步驟、驗證與疑難排解。如果已有部署頁面，請連過去或把這頁放在其下方。」

多給這些背景資訊，能幫助技能判斷正確的內容類型與結構，而不是只根據一段短摘要自行猜測。

建頁前先讀懂工作流程

這個 repo 的核心路徑是：辨識內容 → 分類型態 → 組織頁面 → 找到 Notion 中的目的地 → 建立頁面 → 讓它可被搜尋與發現。若你的工作區有特定的資料庫或 hub 頁面，使用前先把這些對應關係整理好，讓技能能正確搜尋或指向它們，而不是建立彼此孤立的頁面。

notion-knowledge-capture 技能 FAQ

notion-knowledge-capture 只適用於 Notion wiki 嗎？

不是。它不只限於 wiki 頁面。這個技能也支援寫入資料庫或獨立頁面，取決於你的工作區怎麼組織。只要 Notion 是儲存系統，它就很適合用來整理決策紀錄、FAQ、操作文件與學習筆記。

這和一般提示詞有什麼不同？

一般提示詞可能只會摘要一段對話，但 notion-knowledge-capture 的目標是讓內容可以重複利用。它會幫代理選擇文件類型、整理內容結構，並放到其他人日後找得到的位置；這正是臨時性提示詞最常出錯的地方。

這個技能適合新手嗎？

適合，只要使用者能用白話描述想要的結果。新手通常在明確說出目的地類型時會得到更好的結果，例如 wiki、FAQ 或決策紀錄，因為這樣技能就能對應到清楚的範本，而不是靠臨場發揮。

什麼情況下不該使用這個技能？

如果你只是想要快速摘要、私下筆記，或是一個不打算發布到 Notion 的一次性答案，就不要用它。若你的工作區沒有清楚的分類架構，它也不太適合，因為可發現性取決於頁面應該連到哪裡。

如何改進 notion-knowledge-capture 技能

事先補上缺少的背景

最大的品質提升來自於先提供技能無法自行推斷的決策背景：受眾是誰、發生了哪些變更、最後做了什麼決定、以及頁面應該連到哪裡。針對 notion-knowledge-capture install 的決策，也請一併註明團隊已在使用的 Notion 資料庫、父頁面或命名規則。

明確說出你要的內容類型

當你直接點名目標格式時，這個技能表現會更好：操作指南、FAQ 條目、決策紀錄、會議摘要或參考頁面。若你省略這點，代理就得從對話內容自行推斷類型，容易導致結構不對或缺少必要段落。

留意常見失誤模式

最常見的失誤包括摘要過於泛化、標題不夠精準，以及頁面沒有接上工作區的其他內容。另一種失誤是把決策或流程當成普通筆記處理；若要達到 notion-knowledge-capture guide 的品質，輸出應該包含能讓頁面易於掃讀、也方便重複使用的段落。

先出第一版，再迭代優化

拿到第一版後，可以透過補充範例、精確指令、具名替代方案，或做出該決策背後的具體理由來改進。如果頁面是用於知識庫寫作，請要求代理把標題收斂得更精準、加入相關頁面的連結，並刪掉任何對未來讀者的行動、比較或排錯沒有幫助的內容。