前言¶
很多團隊把需求、競品筆記、技術方案、會議紀要都堆在 Notion 裏。信息確實在，但要用的時候往往得自己翻十幾頁、對照幾份筆記，再手工整理成簡報或對比表。來回切換、漏引用來源、結論對不上原始頁面，是知識工作裏很常見的摩擦。
Agent Skill 格式（SKILL.md）把可複用的工作流打包成文件夾，Agent 按描述自動或按指令加載。OpenAI 在公開目錄 openai/skills 的 .curated 分類裏提供了 notion-research-documentation：在已連接 Notion MCP 的前提下，跨頁面檢索、綜合證據，並寫成帶引用的簡報、摘要、對比或完整報告。本文按官方 SKILL.md 與相關說明，介紹它是什麼、怎麼裝、怎麼用。
這是什麼¶
notion-research-documentation 的官方描述是：在 Notion 中跨頁面做調研，並把結果綜合成結構化文檔；適用於需要從多個 Notion 來源整理簡報、對比分析或報告，且要求帶來源引用的場景。
- 歸屬：收錄在 openai/skills 倉庫的
skills/.curated/notion-research-documentation（curated 技能，可按名稱安裝）。Notion 側也有同名工作流出現在 makenotion/claude-code-notion-plugin 中，核心步驟一致：搜索 → 拉取 → 綜合 → 新建頁面。 - 解決什麼問題：把「分散在多頁的事實、指標、主張」收成一份可讀文檔，正文內聯引用，文末集中 Sources，必要時給出建議與後續動作。
- 依賴：它不是單獨爬 Notion 網頁，而是通過 Notion MCP 暴露的工具（如
Notion:notion-search、Notion:notion-fetch、Notion:notion-create-pages、Notion:notion-update-page）讀寫工作區。未連接 MCP 時，官方流程要求先暫停並完成接入。
說明：openai/skills 倉庫 README 已標註該倉庫 deprecated，後續 Codex 技能/插件示例以 openai/plugins 與官方 Build plugins 文檔爲準；下文安裝命令仍以該 curated 目錄當前公開的 $skill-installer 用法爲準。
核心功能與亮點¶
結合官方 SKILL.md、reference/ 與 examples/，能力可以概括爲下面幾塊。
-
先搜後讀，再確認範圍
用Notion:notion-search做定向檢索；結果較多時與用戶確認範圍。再用Notion:notion-fetch讀全文，摘取事實、日期、指標、約束，並記錄頁面 URL/ID 供引用。 -
按目標選輸出體裁
reference/format-selection-guide.md給出決策樹與篇幅參考：
- 多方案權衡 → Comparison（約 800–1200 詞）
- 時效性強、話題簡單 → Quick Brief（約 200–400 詞）
- 正式/戰略級長文 → Comprehensive Report（約 1500+ 詞）
- 其餘默認 → Research Summary（約 500–1000 詞）
對應模板在reference/下（如quick-brief-template.md、research-summary-template.md、comparison-template.md、comprehensive-report-template.md）。 -
綜合時強調證據與缺口
先列提綱，按主題/問題歸類；關鍵事實優先保留直接摘錄並綁定來源；標出信息缺口或互相矛盾之處，始終對齊用戶目標（決策、摘要、計劃或建議）。 -
寫回 Notion，並帶引用
用Notion:notion-create-pages按模板創建頁面，通常包含標題、摘要、關鍵發現、支撐證據、建議/下一步；正文內聯引用，文末 References/Sources。後續可用Notion:notion-update-page追加變更說明。 -
附帶可複用參考與示例
-reference/：高級搜索、格式選擇、各模板、引用規範等
-examples/：競品分析、技術排查、市場調研、行程規劃等端到端演示
安裝與啓用¶
這類 Skill 遵循通用 Agent Skills 約定，可在支持該標準的工具中使用。不同工具的安裝目錄和啓用方式不同，下面只寫已覈實的做法。
1. 先接通 Notion MCP¶
官方 Skill 寫明：若 MCP 調用失敗，先完成 Notion MCP 接入。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，再繼續調研流程。Notion 官方也說明 MCP 可對接 Cursor、Claude Code、Codex 等 MCP 客戶端，服務端點爲 https://mcp.notion.com/mcp（推薦 Streamable HTTP）。在 Cursor 等工具裏按各自 MCP 設置添加同一 URL 並完成授權即可；未授權時搜索/讀寫都會失敗。
2. 在 Codex 中安裝該 Skill¶
curated 技能可在 Codex 會話裏用內置 $skill-installer 按名稱安裝（默認對應 skills/.curated）：
$skill-installer notion-research-documentation
也可按目錄 URL 安裝：
$skill-installer install https://github.com/openai/skills/tree/main/skills/.curated/notion-research-documentation
安裝後重啓 Codex。官方文檔說明：CLI/IDE 中可用 /skills 或 $ 顯式點名技能；描述匹配時也可由 Agent 隱式選用。
3. 在 Cursor 中放置 Skill¶
Cursor 會從項目或用戶目錄加載 Skills，例如：
| 位置 | 範圍 |
|---|---|
.cursor/skills/ 或 .agents/skills/ |
項目級 |
~/.cursor/skills/ 或 ~/.agents/skills/ |
用戶級 |
兼容加載 .claude/skills/、.codex/skills/ 及對應用戶目錄。將本 Skill 文件夾（至少含 SKILL.md，建議連同 reference/、examples/）放到上述某一路徑，例如：
.cursor/skills/notion-research-documentation/SKILL.md
在 Agent 對話裏用 / 搜索技能名顯式調用，或在任務描述匹配 description 時由 Agent 自動選用。也可在 Customize → Skills 查看已發現技能。從 GitHub 導入時，可按 Cursor 文檔通過 Remote Rule (Github) 等方式引入倉庫內容。
4. 在 Claude Code 等工具中¶
若使用 Notion 官方插件倉庫中的同名 Skill，按該插件的安裝說明啓用即可；工作流仍依賴 Notion MCP 的 search/fetch/create 一類工具。未在官方材料中寫明的路徑與命令，這裏不臆造。
典型用法示例¶
官方 Quick start 可概括爲五步：
Notion:notion-search檢索，並與用戶確認範圍Notion:notion-fetch拉取頁面，按reference/citations.md記錄引用- 按
format-selection-guide.md選定 brief / summary / comparison / comprehensive - 用對應模板起草，經
Notion:notion-create-pages寫入 Notion - 補全 Sources；有更新時用
Notion:notion-update-page
examples/competitor-analysis.md 演示了「調研競品定價並做對比文檔」：
用戶意圖示例：
Research competitor pricing models and create a comparison document
檢索示意（官方示例中的調用形態）：
Notion:notion-search
query: "competitor pricing"
query_type: "internal"
filters: {
created_date_range: {
start_date: "2024-01-01"
}
}
隨後對命中頁面逐個 Notion:notion-fetch，再 Notion:notion-create-pages 生成對比頁（含 Executive Summary、對比矩陣、分競品分析、建議與 Sources）。技術排查、市場調研、行程規劃等見同目錄其他示例。
在 Codex 中也可顯式點名，例如：
$notion-research-documentation 根據 Notion 裏最近的技術方案頁，寫一份研究摘要並帶回鏈引用
在 Cursor 中則可用 /notion-research-documentation（以實際發現的技能名爲準）配合同類自然語言需求。
適用場景與注意事項¶
適合：
- 產品/策略：競品對比、選項權衡、決策簡報
- 工程：跨多頁技術方案的排查紀要或調查摘要
- 知識管理：把散落筆記收成帶引用的研究報告或高管可讀長文
- 需要「結論可回溯到原頁面」的協作場景
注意：
- 必須先有 Notion MCP 且賬號有權限；搜不到或打不開頁面時，先檢查連接、團隊空間與頁面權限（Notion 側同名 Skill 也提示過這類問題）。
- 輸出質量受工作區內容限制：Skill 綜合的是你能訪問到的 Notion 內容，不會憑空補全未寫入的事實。
- 注意時效：官方建議覈對頁面 last-edited；過時信息應在文中標明。
- 多結果時先確認範圍，避免把不相關頁面寫進同一份報告。
- 倉庫遷移：若你主要跟 Codex 插件生態，留意
openai/skills的 deprecation 說明，以當前官方 plugins / skills 文檔爲準覈對安裝入口。
小結¶
notion-research-documentation 把「Notion 多頁檢索 → 證據綜合 → 按模板成文 → 帶回鏈寫回」收成一套可複用 Agent 工作流。對已經把知識沉澱在 Notion 裏的團隊，它減少的是手工翻頁與整理，而不是替代你對結論負責。接好 Notion MCP，裝好 Skill，從一次具體的對比或摘要任務試起即可。
官方目錄：
https://github.com/openai/skills/tree/main/skills/.curated/notion-research-documentation
