notion-knowledge-capture

notion-knowledge-capture 技能概覽

notion-knowledge-capture 是一套以 Notion 為核心的擷取工作流程，專門把零散的對話、筆記與決策整理成可搜尋、可連結、可重複利用的結構化頁面。它最適合已經確定要把內容放進 Notion，但在下筆之前還需要協助判斷頁面類型與版型的人。

當你的需求不是「把這段聊天摘要一下」，而是「把它放進正確的 Notion 結構」時，就該使用 notion-knowledge-capture 技能。它的主要價值，是幫你把內容導向團隊知識庫、操作指南、FAQ、決策紀錄或學習筆記，而不是全都塞進同一頁泛用摘要。

這個 notion-knowledge-capture 技能最擅長什麼

當原始素材帶有足夠脈絡、能保留意思時，notion-knowledge-capture 技能表現最好：像是有取捨的決策、附帶步驟與坑點的流程，或是應該整理成可重用 FAQ 的問答串。它著重的不是文采，而是知識系統的編輯與封裝。

什麼情況下適合使用 notion-knowledge-capture

如果你需要一個能從相關紀錄互相連結、由團隊共同維護，並且會隨時間持續更新的 Notion 頁面，就很適合用 notion-knowledge-capture。對於 Knowledge Capture 類型的工作流程來說，只要輸出需要是有結構的，而不只是「看得懂」，它就很合用。

你需要先知道的主要取捨

這個技能很依賴你是否選對內容類型與目的地。如果來源內容太模糊，結果就容易變得很泛。如果你已經知道受眾、用途與目標資料庫，輸出就會比一次性提示詞實用得多。

如何使用 notion-knowledge-capture 技能

安裝 notion-knowledge-capture

要安裝 notion-knowledge-capture，請從 OpenAI skills collection 加入這個技能：

npx skills add openai/skills --skill notion-knowledge-capture

如果工作流程會碰到 Notion，請先確認 Notion MCP server 已可用。這個技能預期 Notion 工具鏈已經連上，才能在正確的位置搜尋、抓取、建立與更新頁面。

先閱讀這些檔案

先看 SKILL.md 了解擷取流程，再檢查對應內容類型與資料庫結構的參考檔。最值得優先閱讀的是 reference/team-wiki-database.md、reference/how-to-guide-database.md、reference/faq-database.md、reference/decision-log-database.md 和 reference/documentation-database.md。

如果你想知道什麼叫做「做得好」，可以先讀 examples/decision-capture.md、examples/how-to-guide.md 和 examples/conversation-to-faq.md。至於預期行為，evaluations/conversation-to-wiki.json 與 evaluations/decision-record.json 這兩個評估檔特別有參考價值。

在呼叫之前先把需求形狀整理好

要得到好結果，關鍵是先給技能一份清楚的擷取簡報，而不是直接丟一段原始逐字稿。請包含：

• 內容類型：decision、how-to、FAQ、learning 或 documentation
• 受眾：team、新人、engineer、customer support 等
• 目的地：既有資料庫、hub page，或請技能幫你找
• 原始脈絡：截取內容之前發生了什麼、哪些資訊重要、哪些該保留
• 限制條件：保留名稱、日期、命令或連結；如有需要可省略敏感細節

一個強而有力的提示詞會像這樣：「把這段部署討論整理成 engineering wiki 的 how-to guide。請保留精確命令、加入前置條件與疑難排解，若已有合適頁面，就把它連到 team wiki。」

notion-knowledge-capture 技能 FAQ

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

是，這個技能是以 Notion 作為儲存與連結層來設計的。如果你要的是純文字摘要、一般 markdown 筆記，或非 Notion 文件，這個技能多半就太重了。

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

一般提示詞可能只會做摘要，但 notion-knowledge-capture 的目標是產出可長期保存的知識資產。notion-knowledge-capture 指南會協助你選對頁面類型、保留原始脈絡，並把成果放到別人日後找得到的位置。

使用它一定要很熟嗎？

不需要，但你要知道預期成果是什麼。初學者最適合先回答兩個問題：「這應該變成什麼類型的頁面？」以及「它應該放在 Notion 的哪裡？」如果你現在還回答不出來，也可以先請技能根據對話內容推斷。

什麼時候不該用它？

如果只是輕量腦力激盪、暫時性的聊天整理，或是不會再被重用的內容，就不適合用 notion-knowledge-capture。當原始素材太單薄，無法支撐一個結構化頁面時，它也是不太好的選擇，因為輸出雖然會很正式，卻不一定真的有價值。

如何改進 notion-knowledge-capture 技能

提供更完整的原始脈絡

品質提升最大的關鍵，是補上對話周邊缺失的脈絡。告訴它現在在做什麼決策、要記錄什麼流程，或使用者到底在問哪一種 FAQ。對 notion-knowledge-capture 而言，在 Knowledge Capture 工作裡，脈絡就是避免頁面變成泛泛回顧的關鍵。

指定目的地結構

如果你知道目標資料庫，就直接說明。「放進 decision log」或「使用 team wiki database」可以讓技能對應到正確的 schema 與措辭。如果你不知道，就先請它搜尋 Notion，再決定最合適的 parent page 或 database。

留意這些失敗模式

最常見的問題是頁面類型選錯、缺少來源連結，以及技術細節被過度抹平。如果第一次輸出太寬泛，可以要求更緊的標題層級、保留命令、更清楚的 owner，或更明確的 rationale 區段。如果內容太稀薄，請直接提供原始逐字稿或筆記，不要只給摘要。

用具體修改逐步迭代

第一版頁面完成後，可以透過明確修改來改善 notion-knowledge-capture 的使用效果：加入 troubleshooting、拆分 action items、連結相關文件，或為不同受眾改寫 overview。這個技能最有效的用法，不是反覆換句話說，而是針對結構與完整度做第二輪修正。