前言¶

用 Cursor、Codex 這類 AI 編程工具寫代碼時，對話裏經常會留下不少「值錢」的內容：一次架構選型的理由、一段上線步驟、幾個反覆被問到的坑。問題是，這些內容往往停在聊天窗口裏——過幾天想找，只能翻歷史記錄；新人要上手，又得再問一遍。

Notion 本來就是很多團隊的 Wiki 和文檔中心。若能在對話結束時，把結論整理成結構化頁面，並掛到對應數據庫裏，知識才會真正沉澱下來。notion-knowledge-capture 就是做這件事的 Agent Skill：把聊天與筆記轉成可鏈接、可複用的 Notion 頁面。

這是什麼¶

notion-knowledge-capture 出自 OpenAI 的 Agent Skills 目錄（openai/skills 倉庫中的 .curated 精選技能），定位很明確：把對話與決策捕獲爲結構化 Notion 頁面，適合寫成團隊 Wiki、How-To、決策記錄（ADR）、FAQ、學習筆記或正式文檔。

它依賴 Notion 官方託管的 MCP 服務（https://mcp.notion.com/mcp），通過 notion-search、notion-fetch、notion-create-pages、notion-update-page 等工具讀寫工作區。Skill 本身主要是一份帶工作流與模板的 SKILL.md，再加上 reference/ 數據庫說明和 examples/ 示例；Agent 讀到後按流程執行。

說明一點：openai/skills 倉庫 README 已提示該倉庫進入棄用狀態，後續 Codex 插件/技能示例更推薦看 OpenAI Plugins 相關文檔；但本 Skill 的 SKILL.md、參考模板與示例仍可在當前目錄獲取，安裝命令在 skills.sh、MCPServers 等目錄頁也仍指向同一路徑。以一手 SKILL.md 爲準即可。

核心功能與亮點¶

根據官方 SKILL.md 與配套文件，能力可以概括爲下面幾塊。

1、六類內容模板
reference/ 裏爲不同用途準備了數據庫說明，包括：

team-wiki-database.md：團隊 Wiki
how-to-guide-database.md：操作指南
faq-database.md：FAQ
decision-log-database.md：決策日誌
documentation-database.md：文檔庫
learning-database.md：學習/覆盤筆記

另有 database-best-practices.md，講屬性命名、Owner、Status、Tags 等通用約定。

2、固定五步工作流
先明確「要捕獲什麼、給誰看」，再選對數據庫，從對話裏抽出事實/決策/步驟，用 Notion MCP 創建或更新頁面，最後回鏈到 Hub 頁、補上摘要與負責人。不是把聊天原文原樣貼進 Notion，而是按類型結構化。

3、先搜再寫，避免重複頁
官方 Quick Start 要求先用 Notion:notion-search，再用 Notion:notion-fetch 拉取已有頁面或庫結構，確認是新建還是更新，並拿到正確的屬性名與 data_source_id。

4、可發現性
創建後還會更新 Hub、加 relation/backlink；若有後續事項，可在相關任務庫裏建任務並互鏈。agents/openai.yaml 裏的默認提示詞也強調：捕獲決策、行動項，以及已知的負責人（owners）。

安裝與啓用¶

這類 Skill 基於通用 SKILL.md 格式，可在支持 Agent Skills 的工具裏使用。安裝方式以目錄頁與倉庫說明爲準。

安裝 Skill¶

跨工具較常見的安裝命令（skills.sh / MCPServers 目錄頁均給出）：

npx skills add https://github.com/openai/skills --skill notion-knowledge-capture

在 Codex 中，倉庫 README 說明可用內置的 $skill-installer 按名稱安裝 curated 技能，例如：

$skill-installer notion-knowledge-capture

安裝後按所用工具要求重啓 Agent，以便發現新 Skill。Cursor 側安裝成功後，技能目錄一般會出現在項目的 .cursor/skills/notion-knowledge-capture（以 CLI 實際落盤爲準）。

連接 Notion MCP（必需）¶

沒有 Notion MCP，Skill 無法真正讀寫頁面。官方 SKILL.md 針對 Codex 的步驟是：

codex mcp add notion --url https://mcp.notion.com/mcp

啓用遠程 MCP 客戶端（二選一）：

# config.toml
[features]
rmcp_client = true

或：

codex --enable rmcp_client

然後 OAuth 登錄：

codex mcp login notion

登錄成功後需要重啓 Codex，再繼續捕獲流程。

若你主要用 Cursor，可按 Notion 官方 MCP 文檔配置。全局或項目級 .cursor/mcp.json 示例：

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

保存並重啓 Cursor，首次調用 Notion 工具時完成 OAuth。Claude Code 可用：

claude mcp add --transport http notion https://mcp.notion.com/mcp

再在會話裏用 /mcp 完成授權。

Notion 推薦使用託管 MCP（https://mcp.notion.com/mcp），開源的本地 notion-mcp-server 已不再積極維護。

典型用法示例¶

Skill 自帶 examples/，下面壓縮自官方「決策捕獲」與「How-To」示例，便於對照自己的提示詞。

1. 把架構討論寫成決策記錄¶

用戶可以說：

把我們「客戶 API 從 REST 遷到 GraphQL」的決定寫進 Notion 決策庫，
補上備選方案、理由、影響面和負責人。

Agent 大致會：

從對話抽出 Decision / Context / Alternatives / Rationale
Notion:notion-search，例如查詢 "architecture decisions" 或 "ADR"
Notion:notion-fetch 拿到庫屬性（如 Decision、Date、Status、Domain、Impact 等）
Notion:notion-create-pages，指定正確的 data_source_id，寫入標題與屬性，正文按 ADR 結構展開
從 Architecture Wiki 等 Hub 頁加回鏈

官方示例裏創建頁面時的調用形態類似：

Notion:notion-create-pages
parent: { data_source_id: "decision-log-collection-id" }
pages: [{
  properties: {
    "Decision": "Migrate to GraphQL API",
    "date:Date:start": "2025-10-16",
    "Status": "Accepted",
    "Domain": "Architecture",
    "Impact": "High"
  },
  content: "（含 Context / Decision / Options / Consequences / Plan）"
}]

實際屬性名必須以你工作區裏 notion-fetch 返回的 schema 爲準，不要照抄佔位 id。

2. 把上線討論收成 How-To¶

用戶可以說：

把剛纔關於生產環境發佈的討論存成 How-To，
寫上前置條件、步驟、驗證清單和排障，並掛到工程 Wiki。

官方示例會整理成：Overview & Prerequisites → 編號步驟 → Verification → Troubleshooting → Related Docs，創建後再用 Notion:notion-update-page 把鏈接插回 Wiki 索引頁。

3. 直接用默認意圖¶

agents/openai.yaml 提供的默認提示詞是：

Capture this conversation into structured Notion pages with decisions,
action items, and owners when known.

適合會話結束後一鍵沉澱：有決策就進決策庫，有步驟就進 How-To，並儘量帶上 Owner。

適用場景與注意事項¶

比較適合：

團隊已用 Notion 做 Wiki / ADR / FAQ，希望把 AI 編程會話裏的結論自動入庫
需要固定版式：決策要寫備選方案，How-To 要寫前置條件與排障
多人協作，依賴 Tags、Owner、Status、Hub 回鏈做發現與責任追蹤

使用時注意：

必須先連好 Notion MCP，並完成 OAuth；權限以你在 Notion 工作區能訪問的範圍爲界。
先 fetch schema 再寫屬性；屬性名、類型、data_source_id 因庫而異，硬編碼容易失敗。
多個候選庫時要選庫；Skill 要求不確定時詢問用戶，而不是隨便寫進某一個庫。
適合結構化知識，不適合整段聊天日誌搬家；敏感信息入庫前應自行脫敏。
倉庫狀態：寫文章時 openai/skills README 已標註 deprecated，長期維護與分發渠道可能遷移；安裝前建議再看一眼官方目錄與 Notion MCP 文檔是否有更新。

小結¶

notion-knowledge-capture 把「AI 寫代碼時聊出來的知識」接到 Notion 的結構化知識庫上：選對庫、抽結構、創建/更新頁面、再掛回 Hub。對已經用 Notion 做團隊文檔的工程組來說，這是一條很直接的「對話 → Wiki」工作流。

官方目錄：

https://github.com/openai/skills/tree/main/skills/.curated/notion-knowledge-capture

Notion MCP 接入說明：

https://developers.notion.com/guides/mcp/get-started-with-mcp

用 notion-knowledge-capture 把 AI 對話沉澱成 Notion 知識庫

前言¶

這是什麼¶

核心功能與亮點¶

安裝與啓用¶

安裝 Skill¶

連接 Notion MCP（必需）¶

典型用法示例¶

1. 把架構討論寫成決策記錄¶

2. 把上線討論收成 How-To¶

3. 直接用默認意圖¶

適用場景與注意事項¶

小結¶

精选优惠券

用 notion-knowledge-capture 把 AI 對話沉澱成 Notion 知識庫

前言¶

這是什麼¶

核心功能與亮點¶

安裝與啓用¶

安裝 Skill¶

連接 Notion MCP（必需）¶

典型用法示例¶

1. 把架構討論寫成決策記錄¶

2. 把上線討論收成 How-To¶

3. 直接用默認意圖¶

適用場景與注意事項¶

小結¶

精选优惠券

相關文章