mcpField
N
notion-research-documentation

notion-research-documentation

github.com/openai生产力28.4k3.7k 次安装18 周前更新
代码仓库

关于 notion-research-documentation

用于检索 Notion 页面、综合研究发现并发布带引用的简报或报告的技能。它引导 Codex 完成来源搜索、格式选择、起草和更新。

主要功能

  1. 01搜索并获取 Notion 页面
  2. 02综合发现并注明来源
  3. 03选择报告格式和模板
  4. 04创建和更新 Notion 页面

适用场景

  1. 01撰写带引用的研究简报
  2. 02依据来源页面比较选项
  3. 03汇编深入报告

MCP 相关

使用 Notion MCP 工具搜索、获取、创建和更新页面。调用失败时提供连接 Notion MCP 的设置步骤。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/openai/skills --skill notion-research-documentation

安装后在 Claude Code 中输入/notion-research-documentation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE.txt
agents/
openai.yaml
assets/
notion-small.svg
evaluations/
basic-research.json
README.md
research-to-database.json
examples/
competitor-analysis.md
market-research.md
technical-investigation.md
trip-planning.md
reference/
advanced-search.md
citations.md
comparison-format.md
comparison-template.md
comprehensive-report-format.md
comprehensive-report-template.md
format-selection-guide.md
quick-brief-format.md
quick-brief-template.md
research-summary-format.md
research-summary-template.md

详细介绍

研究与文档

拉取相关的 Notion 页面,综合整理研究结果,并发布清晰的简报或报告(附带引文和来源链接)。

快速开始

  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 更新。

工作流

0) 如果因 Notion MCP 未连接而导致任何 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 登录:
    • codex mcp login notion

登录成功后,用户必须重启 codex。你应完成回答,并告诉他们再次尝试时可以继续进行第 1 步。

1) 收集来源
  • 先搜索(Notion:notion-search);优化查询,如果出现多个结果,请让用户确认。
  • 获取相关页面(Notion:notion-fetch),快速浏览其中的事实、指标、主张、约束和日期。
  • 记录每个来源的 URL/ID 以便后续引用;对关键事实优先使用直接引用。
2) 选择格式
  • 快速了解 → 快速简报。
  • 单主题深入 → 研究摘要。
  • 方案权衡 → 对比。
  • 深度剖析 / 面向管理层 → 综合报告。
  • 关于每种格式何时选用,请参阅 reference/format-selection-guide.md。
3) 综合整理
  • 写作前先列提纲;按主题/问题对研究结果进行归类。
  • 用来源 ID 标注证据;标记缺口或矛盾之处。
  • 始终关注用户目标(决策、摘要、计划、建议)。
4) 创建文档
  • 在 reference/ 中选择匹配的模板(简报、摘要、对比、综合)并加以调整。
  • 使用 Notion:notion-create-pages 创建页面;在相关时包含标题、摘要、关键发现、支持性证据以及建议/后续步骤。
  • 添加行内引文和参考文献部分;链接回来源页面。
5) 最终确定与交接
  • 添加要点、风险和待解决问题。
  • 如果用户需要后续跟进,在页面中创建任务或清单;如适用,链接任何任务数据库条目。
  • 更新时使用 Notion:notion-update-page 分享简短的变更日志或状态。

参考资料和示例

  • 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)。

评论

支持 Markdown