关于 notion-research-documentation
用于检索 Notion 页面、综合研究发现并发布带引用的简报或报告的技能。它引导 Codex 完成来源搜索、格式选择、起草和更新。
主要功能
- 01搜索并获取 Notion 页面
- 02综合发现并注明来源
- 03选择报告格式和模板
- 04创建和更新 Notion 页面
适用场景
- 01撰写带引用的研究简报
- 02依据来源页面比较选项
- 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.txtagents/openai.yamlassets/notion-small.svgevaluations/basic-research.jsonREADME.mdresearch-to-database.jsonexamples/competitor-analysis.mdmarket-research.mdtechnical-investigation.mdtrip-planning.mdreference/advanced-search.mdcitations.mdcomparison-format.mdcomparison-template.mdcomprehensive-report-format.mdcomprehensive-report-template.mdformat-selection-guide.mdquick-brief-format.mdquick-brief-template.mdresearch-summary-format.mdresearch-summary-template.md详细介绍
研究与文档
拉取相关的 Notion 页面,综合整理研究结果,并发布清晰的简报或报告(附带引文和来源链接)。
快速开始
- 使用
Notion:notion-search通过有针对性的查询查找来源;与用户确认范围。 - 通过
Notion:notion-fetch获取页面;记录关键章节并捕获引文(reference/citations.md)。 - 使用
reference/format-selection-guide.md选择输出格式(简报、摘要、对比、综合报告)。 - 使用匹配的模板(快速、摘要、对比、综合),通过
Notion:notion-create-pages在 Notion 中起草。 - 链接来源并添加参考文献/引文部分;有新信息时使用
Notion:notion-update-page更新。
工作流
0) 如果因 Notion MCP 未连接而导致任何 MCP 调用失败,请暂停并进行设置:
- 添加 Notion MCP:
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。你应完成回答,并告诉他们再次尝试时可以继续进行第 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