notion-research-documentation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Research & Documentation

研究与文档整理

Pull relevant Notion pages, synthesize findings, and publish clear briefs or reports (with citations and links to sources).
提取相关的Notion页面,整合研究结果,并发布清晰的简报或报告(包含引用和来源链接)。

Quick start

快速开始

  1. Find sources with
    Notion:notion-search
    using targeted queries; confirm scope with the user.
  2. Fetch pages via
    Notion:notion-fetch
    ; note key sections and capture citations (
    reference/citations.md
    ).
  3. Choose output format (brief, summary, comparison, comprehensive report) using
    reference/format-selection-guide.md
    .
  4. Draft in Notion with
    Notion:notion-create-pages
    using the matching template (quick, summary, comparison, comprehensive).
  5. Link sources and add a references/citations section; update as new info arrives with
    Notion:notion-update-page
    .
  1. 使用针对性查询通过
    Notion:notion-search
    查找来源;与用户确认范围。
  2. 通过
    Notion:notion-fetch
    获取页面;标记关键部分并记录引用(
    reference/citations.md
    )。
  3. 使用
    reference/format-selection-guide.md
    选择输出格式(简报、摘要、对比分析、综合报告)。
  4. 使用匹配的模板(快速简报、摘要、对比分析、综合报告)通过
    Notion:notion-create-pages
    在Notion中起草文档。
  5. 链接来源并添加参考文献/引用部分;当有新信息时,通过
    Notion:notion-update-page
    更新文档。

Workflow

工作流

0) If any MCP call fails because Notion MCP is not connected, pause and set it up:

0) 如果因未连接Notion MCP导致任何MCP调用失败,请暂停并进行设置:

  1. Add the Notion MCP:
    • codex mcp add notion --url https://mcp.notion.com/mcp
  2. Enable remote MCP client:
    • Set
      [features].rmcp_client = true
      in
      config.toml
      or run
      codex --enable rmcp_client
  3. Log in with OAuth:
    • codex mcp login notion
After successful login, the user will have to restart codex. You should finish your answer and tell them so when they try again they can continue with Step 1.
  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登录:
    • codex mcp login notion
登录成功后,用户需要重启codex。当用户再次尝试时,你应完成回答并告知他们可以继续执行步骤1。

1) Gather sources

1) 收集来源

  • Search first (
    Notion:notion-search
    ); refine queries, and ask the user to confirm if multiple results appear.
  • Fetch relevant pages (
    Notion:notion-fetch
    ), skim for facts, metrics, claims, constraints, and dates.
  • Track each source URL/ID for later citation; prefer direct quotes for critical facts.
  • 先进行搜索(
    Notion:notion-search
    );优化查询,如果出现多个结果,请让用户确认。
  • 获取相关页面(
    Notion:notion-fetch
    ),略读以提取事实、指标、主张、约束条件和日期。
  • 跟踪每个来源的URL/ID以便后续引用;对于关键事实,优先使用直接引述。

2) Select the format

2) 选择格式

  • Quick readout → quick brief.
  • Single-topic dive → research summary.
  • Option tradeoffs → comparison.
  • Deep dive / exec-ready → comprehensive report.
  • See
    reference/format-selection-guide.md
    for when to pick each.
  • 快速读取 → 快速简报。
  • 单一主题深入研究 → 研究摘要。
  • 方案权衡 → 对比分析。
  • 深度研究 / 面向高管 → 综合报告。
  • 何时选择每种格式,请参阅
    reference/format-selection-guide.md

3) Synthesize

3) 整合信息

  • Outline before writing; group findings by themes/questions.
  • Note evidence with source IDs; flag gaps or contradictions.
  • Keep user goal in view (decision, summary, plan, recommendation).
  • 写作前先列大纲;按主题/问题分组研究结果。
  • 用来源ID标记证据;标注信息缺口或矛盾点。
  • 始终牢记用户目标(决策、摘要、计划、建议)。

4) Create the doc

4) 创建文档

  • Pick the matching template in
    reference/
    (brief, summary, comparison, comprehensive) and adapt it.
  • Create the page with
    Notion:notion-create-pages
    ; include title, summary, key findings, supporting evidence, and recommendations/next steps when relevant.
  • Add citations inline and a references section; link back to source pages.
  • reference/
    中选择匹配的模板(简报、摘要、对比分析、综合报告)并进行调整。
  • 通过
    Notion:notion-create-pages
    创建页面;包含标题、摘要、关键发现、支持证据,以及相关的建议/下一步行动。
  • 内联添加引用并设置参考文献部分;链接回来源页面。

5) Finalize & handoff

5) 定稿与交付

  • Add highlights, risks, and open questions.
  • If the user needs follow-ups, create tasks or a checklist in the page; link any task database entries if applicable.
  • Share a short changelog or status using
    Notion:notion-update-page
    when updating.
  • 添加重点内容、风险点和待解决问题。
  • 如果用户需要后续跟进,在页面中创建任务或检查清单;如有适用,链接任务数据库条目。
  • 更新文档时,使用
    Notion:notion-update-page
    分享简短的变更日志或状态说明。

References and examples

参考资料与示例

  • reference/
    — search tactics, format selection, templates, and citation rules (e.g.,
    advanced-search.md
    ,
    format-selection-guide.md
    ,
    research-summary-template.md
    ,
    comparison-template.md
    ,
    citations.md
    ).
  • examples/
    — end-to-end walkthroughs (e.g.,
    competitor-analysis.md
    ,
    technical-investigation.md
    ,
    market-research.md
    ,
    trip-planning.md
    ).
  • 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
    )。