技能使用指南

notion-research-documentation（Notion研究与文档生成）Skill 是什么？如何安装使用？

Notion研究与文档生成Skill帮你用一句话在Notion中检索多个页面、自动归纳要点，并生成带引用与来源链接的简报、比较文档或研究报告。内置格式选择指南、四套模板与引用规范，支持后续增量更新与任务交接。本文详解MCP安装步骤、五步使用方法、竞品对比与典型场景，助你把分散资料变成可交付文档。

Notion研究与文档生成Skillnotion-research-documentation
9 个章节 约 15 分钟阅读 AI 智能生成

Notion研究与文档生成Skill：把散落在 Notion 的资料，一键合成带引用的结构化报告

  • 一句话定位：在 Notion 中检索多个来源页面，把信息合成为结构化文档——带引用、带来源链接、可直接交付。
  • 核心动作：搜索（notion-search）→ 抓取（notion-fetch）→ 选格式 → 合成提纲 → 建页（notion-create-pages）→ 收尾更新（notion-update-page）。
  • 四种输出格式：快速简报、研究摘要、比较文档、全面报告，按场景自动匹配模板。
  • 安装门槛不高：本质是给 Codex 挂上 Notion 远程 MCP，并完成一次 OAuth 登录；登录后重启客户端即可使用。
  • 最大差异点：不是"帮你写文档"，而是"先帮你把资料找齐、记住出处、标出矛盾，再写成文档"。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

技能中文名：Notion研究与文档生成Skill 技能英文名：notion-research-documentation 技能ID：12027

它解决的问题很具体：团队的知识资产往往散落在 Notion 的几十上百个页面里——需求文档、会议纪要、竞品调研、技术方案、市场数据各自为政。人要写一份"简报"“比较”"研究报告"时，真正耗时的不是写作，而是翻页面、找依据、记住出处、判断哪份资料更新。这个技能就是把这段苦力活标准化：拉取相关 Notion 页面，合成发现，并发布清晰的简报或报告（带引用和来源链接）。

安装思路：一键挂载 MCP，让 AI 真正"看见"你的 Notion

这个技能的能力建立在 Notion MCP（Model Context Protocol）之上。也就是说，安装分两层：先把 Notion 接入你的 AI 客户端，再调用技能工作流。技能详情中给出的真实步骤如下：

前提条件

  • 已安装并可使用 Codex 客户端；
  • 拥有可正常登录的 Notion 账号（后续通过 OAuth 授权）；
  • 网络环境可访问 Notion MCP 服务地址。

安装步骤（以官方说明为准）

  1. 添加 Notion MCP 服务

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

  2. 启用远程 MCP 客户端（二选一）

    • 在 config.toml 中设置 [features].rmcp_client = true，或
    • 启动时运行 codex --enable rmcp_client

  3. 通过 OAuth 登录 Notion

    codex mcp login notion

  4. 重启 Codex 客户端。登录成功后需要重启，之后即可从第一步继续正常使用。

如何验证是否生效 最简单的验证方式：让 AI 执行一次 Notion:notion-search 搜索（例如"帮我搜一下 Notion 里关于季度目标的页面"）。

  • 如果能返回页面列表 → 接入成功；
  • 如果报错、提示 MCP 未连接 → 说明 MCP 尚未就绪。技能详情明确要求：任何 MCP 调用因 Notion MCP 未连接而失败时，应暂停任务并先完成上述配置，而不是让 AI 硬着头皮编造内容。这一点非常关键，它保证了输出不会出现"凭空生成的引用"。

关于技能包的获取入口、是否有付费版本等信息，本文档未提供，请以官方说明为准。

该技能的主要功能和特点

  • 多源检索与范围确认：先用 Notion:notion-search 按目标查询搜索来源；当命中多个结果时，主动向用户确认研究范围，避免"搜到什么写什么"。
  • 页面抓取与事实提取：通过 Notion:notion-fetch 读取页面，重点浏览事实、指标、声明、限制和日期——这几类信息正是报告里最容易出错也最需要出处的部分。
  • 引用追踪机制：为每个来源记录 URL/ID，关键事实优先直接引用，并把引用规范沉淀在 reference/citations.md 中。报告写完后，每条结论都能回溯到原始页面。
  • 格式智能选择：内置 reference/format-selection-guide.md，按需求自动匹配输出形态：
    • 快速浏览 → 快速简报
    • 单主题深入 → 研究摘要
    • 选项权衡 → 比较文档
    • 深入分析 / 高管准备 → 全面报告
  • 模板化产出：reference/ 下提供简报、摘要、比较、全面四套模板，创建页面时直接套用，保证不同人产出的文档结构一致。
  • 矛盾与缺口标记：合成阶段会按主题/问题分组，记录证据对应的来源 ID，并主动标出信息差距或相互矛盾的结论——这是普通"AI 写作"工具几乎不会做的事。
  • 可交接的收尾：文档末尾补充亮点、风险与开放问题；需要跟进时在页面内创建任务或清单，必要时链接任务数据库条目。
  • 支持增量更新：新信息到达时用 Notion:notion-update-page 更新页面，并附上简短变更日志或状态，让读者知道"这份报告改了什么"。

和普通工具比强在哪：普通 AI 写作工具是"你喂材料它写字"，这个技能是"它去找材料、标出处、比差异，再写字，最后写回 Notion"。整个闭环都在 Notion 内完成，不需要导出、复制、再粘贴。

如何使用该技能？

技能详情给出了完整的五步工作流，下面把它翻译成可以直接照着做的操作步骤。

第 1 步：说清目标与范围 用一句话交代"研究什么、给谁看、要做什么决策"。例如：

“帮我梳理 Notion 里近半年的竞品 A 相关资料，输出一份比较文档，用于下周的产品定价讨论。”

第 2 步：让 AI 搜索来源 技能会调用 Notion:notion-search 执行目标查询。如果返回多个结果，它会回来问你确认范围——这一步不要跳过，范围越准，后面的报告越不跑偏。

第 3 步：抓取页面并记录引用 AI 通过 Notion:notion-fetch 逐页抓取，提取事实、指标、声明、限制、日期，并按 reference/citations.md 的规则记录来源 URL/ID。

第 4 步：确认输出格式 参照 reference/format-selection-guide.md 选择格式。你可以直接指定，例如"要一份全面报告"，或让 AI 根据你的目的推荐。

第 5 步：合成与撰写 AI 会先列提纲，再按主题/问题分组，用来源 ID 标注证据，标出矛盾点和资料缺口。这一步的产出是"写作蓝图"，而不是正文。

第 6 步：在 Notion 中生成页面 调用 Notion:notion-create-pages 配合对应模板（快速 / 摘要 / 比较 / 全面）创建页面，内容通常包含：标题、摘要、关键发现、支持证据、建议与下一步、引用与参考部分（链接回来源页面）。

第 7 步：收尾与交接 补充亮点、风险、开放问题；需要跟进的项创建为任务或清单；如有更新，用 Notion:notion-update-page 追加变更日志。

输入输出示例

项目 示例
输入 “把 Notion 里关于这次技术选型的方案页、评审纪要、压测记录都拉出来，做一份技术调研报告，标清楚每个结论的来源。”
中间过程 搜索命中若干页面 → 与你确认范围 → 抓取并记录引用 → 选择"研究摘要/全面报告" → 列提纲并标记某两个页面的 QPS 数据存在矛盾
输出 一个新建的 Notion 页面：摘要、关键发现（每条附来源链接）、矛盾点说明、建议与下一步、参考列表
可复用参考 reference/advanced-search.md（搜索策略）、format-selection-guide.md、research-summary-template.md、comparison-template.md、citations.md
端到端案例 examples/competitor-analysis.md、technical-investigation.md、market-research.md、trip-planning.md

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势 不足
Notion研究与文档生成Skill（notion-research-documentation） 面向 Notion 的多源研究工作流 搜索、抓取、格式选择、合成、建页、引用追踪、增量更新 需配置 Notion MCP + OAuth 登录 + 重启客户端 竞品分析、技术调研、市场研究、决策简报 全流程留在 Notion 内；强制引用可溯源；主动标记矛盾与缺口；四套模板保证一致性 依赖 MCP 连接，首次配置有一次性成本；只覆盖 Notion 内部知识源
Notion 内置 AI 助手 页面级写作与问答 段落续写、摘要、翻译、基于页面的问答 开通即可用，无需配置 单页润色、快速总结 零配置、上手最快 更偏"在页面里帮忙"，跨多页面系统化调研与引用体系需人工补足
通用大模型对话（如聊天式 AI）+ 手动粘贴 通用文本生成 归纳、写作、比较、改写 门槛低，但需人工搬运材料 临时性整理、素材已在手边 灵活、成本低 引用靠人工维护；材料更新需重新粘贴；容易丢失出处、出现无源结论
联网研究/深度搜索类工具 公网信息检索与综述 网页搜索、来源汇总、报告生成 开箱即用 行业趋势、公开资料调研 公网覆盖面广、速度快 触达不到企业内部 Notion 私有知识；无法直接回写企业知识库

怎么选：如果资料主要沉淀在 Notion、且产出需要"能溯源、能交接、能更新"，本技能更贴合；如果只是单页润色，内置 AI 更省事；如果研究对象是公开互联网而非内部知识，联网研究类工具更合适。三者也可以组合使用。

该技能的典型应用场景与实际体验情况

场景一：产品经理做竞品对比 痛点：竞品资料散落在调研纪要、用户访谈、销售反馈等多个页面，每次做对比都要重新翻一遍，且经常引用了过期数据。 使用方式：提出"整理竞品 A/B/C 的功能、定价、目标客群，输出比较文档"。技能会搜索并抓取相关页面，套用 comparison-template.md 生成对比页，价格与功能点各自带来源链接。 实际体验：结构一次成型，最大的收益是能看出哪份资料更新——AI 会把日期一并抓出来，遇到两个页面数据打架会明确标注，而不是悄悄选一个。

场景二：技术负责人做技术调研 痛点：方案页、评审纪要、压测记录分散，写调研报告时容易漏掉关键限制条件（如某方案只在特定数据量下成立）。 使用方式：参照 examples/technical-investigation.md 的做法，让技能抓取全部相关页面，输出"研究摘要/全面报告"，要求列出限制与开放问题。 实际体验：notion-fetch 阶段对"事实、指标、限制、日期"的扫描是有明确指向的，因此漏项明显减少。需要注意的是，若原始页面本身写得含糊，报告也会保留这份含糊——它会标为缺口，但不会替你补数据。

场景三：管理者准备决策简报 痛点：会前需要一份三页以内的材料，包含结论、依据、风险，且每条依据都要能点回原文。 使用方式：要求"快速简报 + 全面报告"组合，先出简报定调，再出全面报告备查。 实际体验：简报模板天然限制篇幅，逼着把"亮点、风险、开放问题"讲清楚；引用区块让人敢在会上说"这条来自 3 月评审纪要"。上手难度低，一次对话即可完成。

场景四：跨部门资料汇总与交接 痛点：项目交接时，接手人不知道该看哪几份文档，历史结论也没人解释。 使用方式：让技能汇总相关页面并生成交接页，在页内创建任务清单，后续有新信息时用 notion-update-page 更新并附变更日志。 实际体验：这可能是长期价值最高的用法——文档不是一次性产物，而是可以持续维护的"活页"。

通用注意事项：① 首次务必完成 MCP 配置并验证；② 搜索命中过多时坚持确认范围，别嫌麻烦；③ 对关键结论抽查原文链接，尤其涉及数字的段落；④ 资料严重不足时，报告里出现"缺口"标注是正常且诚实的表现，不要强行要求 AI 补全。

该技能能为用户带来的价值

  • 把"找资料"的时间压缩成一次对话：原本需要在多个页面间来回切换、复制、比对的工作，被收敛为搜索—抓取—合成三步，写作阶段可以直接从提纲开始。
  • 让结论可溯源，降低沟通成本：引用与参考部分是内建要求，而不是事后补的礼节。讨论时可以直接说"看第三条来源"，减少"这个数据哪来的"的来回。
  • 统一文档质量下限：四套模板 + 格式选择指南，让不同人、不同时间产出的简报与报告结构一致，新人也能交出合格文档。
  • 把隐性风险显性化：主动标记资料矛盾与信息缺口，避免基于过期或冲突的数据做决策。
  • 知识复用而非一次性消费：文档留在 Notion 内，支持后续更新与变更日志，长期积累下来就是一套可检索、可追溯的组织记忆。
  • 降低工具门槛：不需要写检索语句、不需要懂知识库查询语法，用自然语言描述目标即可驱动完整研究流程。

常见问题 FAQ

Q1：怎么安装？安装完怎么确认能用？ A：三步走——codex mcp add notion --url https://mcp.notion.com/mcp 添加服务；在 config.toml 设置 [features].rmcp_client = true（或启动时加 --enable rmcp_client）启用远程 MCP 客户端；执行 codex mcp login notion 完成 OAuth 登录，然后重启 Codex。验证方式：让 AI 跑一次 Notion:notion-search，能返回页面即成功。具体入口与版本要求以官方说明为准。

Q2：收费吗？ A：所提供的技能详情中未包含定价信息，是否收费、是否有免费额度，请以官方说明为准。需要说明的是，该技能依赖 Notion 账号与 MCP 连接，Notion 侧的账号方案按其自身规则执行。

Q3：适合谁用？ A：适合知识资产集中在 Notion 的团队角色——需要出竞品对比的产品经理、需要出技术调研的研发负责人、需要准备决策材料的管理者，以及负责项目交接与文档沉淀的运营/项目经理。如果只是偶尔润色一段文字，内置 AI 助手可能更轻便。

Q4：和 Notion 自带的 AI 有什么区别？ A：内置 AI 更擅长"在页面里帮你写、帮你总结单页内容"；本技能的定位是"跨多个页面的研究工作流"——它强调先确认搜索范围、逐页抓取事实、按规范记录引用、选择合适格式，最后才动笔，并且会把矛盾和缺口标出来，产出还能增量更新。

Q5：如果 AI 说 MCP 没连接怎么办？ A：按技能内置的处理逻辑，此时应暂停任务，先完成 Notion MCP 的添加、远程客户端启用与 OAuth 登录，然后重启客户端，再回到第一步继续。不要在这个状态下让 AI 继续写报告，否则可能出现无来源支撑的内容。