awesome-codex-skills 实战用 Notion Research Documentation Skill 完成多人日本旅行研究规划【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills导读本文以 notion-research-documentation/examples/trip-planning.md 为核心案例完整讲解在 Codex CLI 中借助notion-research-documentationSkill将散落在 Notion 工作区中的历史旅行笔记、餐厅推荐、景点指南检索出来再结合外部调研综合成一份可执行的 10 天行程规划文档的端到端流程。读完本文你将掌握该 Skill 的 MCP 连接方式、搜索—抓取—综合—落库—引用五个核心环节以及如何复用其四种输出格式模板把朋友间的旅行规划这类非结构化需求变成带预算、预订清单和引用来源的结构化文档。一、Skill 定位从 Notion 检索到结构化文档发布notion-research-documentation是 awesome-codex-skills 仓库收录的一个实践型 Skill其元数据见 SKILL.md将其定位为Research across Notion and synthesize into structured documentationuse when gathering info from multiple Notion sources to produce briefs, comparisons, or reports with citations.也就是说它的适用场景是信息源在 Notion 工作区中个人笔记、团队 Wiki、数据库目标是产出带引用、可交付的简报/报告/对比文档。trip-planning 这个例子正是其能力的直观演示——输入的只是一句自然语言需求Research and plan our friends trip to Japan in March - were 6 people looking for 10 days输出却是一份结构完整的出行计划书。从 Skill 的快速开始Quick start清单可以看到它内置的五个步骤用Notion:notion-search按目标查询定位来源并与用户确认范围用Notion:notion-fetch抓取页面记录关键章节并捕获引用规则见 reference/citations.md依据 reference/format-selection-guide.md 选择输出格式用Notion:notion-create-pages按对应模板在 Notion 中起草链接来源并附上引用/参考文献段落有新信息时用Notion:notion-update-page更新。trip-planning.md 正是这条链路的完整落地产物下文逐环节展开。二、前置准备Notion MCP 的连接与配置notion-research-documentationSkill 的所有核心操作都通过 Notion MCP 服务器暴露的notion-search、notion-fetch、notion-create-pages、notion-update-page等工具完成。SKILL.md 的 Workflow 第 0 步专门规定了 MCP 未连接时的排障流程这是运行本 Skill 的硬前提添加 Notion MCPcodex 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 才能生效——SKILL.md 特别提醒若 MCP 调用失败是因为 Notion MCP 未连接应暂停任务并先完成上述配置再回到第 1 步继续执行。三、核心工作流拆解以日本旅行规划为例trip-planning.md 将整个过程划分为四个步骤每一步对应一个明确的 MCP 调用与产出。3.1 第一步搜索既有笔记notion-search工作流首先在工作区内检索与主题相关的历史内容Notion:notion-search query: Japan travel示例中命中了三份高价值来源Japan Travel Guide朋友的笔记、Tokyo Restaurants、Kyoto Temple Guide。这里可以调用 reference/advanced-search.md 中记录的检索技巧来提升命中质量日期范围过滤filters.created_date_range如start_date: 2024-01-01用于聚焦近期信息、排除过时内容创建人过滤filters.created_by_user_ids可锁定特定专家或团队成员的笔记范围限定teamspace_id限定团队空间、page_url限定某个页面及其子页、data_source_url限定数据库内容用于减少噪声多查询并行对同一主题使用多个相关词如 Japan travel、Tokyo itinerary、cherry blossom并行搜索后合并结果。该文档还给出了结果质量判断标准优先抓取高语义匹配、最近编辑、来自权威来源、内容详实的页面结果过多时用过滤器收窄结果过少少于 3 条时放宽查询词、去掉过滤器或尝试同义词。3.2 第二步抓取并提炼要点notion-fetch对命中的页面逐个抓取正文Notion:notion-fetch (3x)trip-planning.md 展示了抓取后提炼出的关键信息这些正是后续综合与预算的原料最佳出行时间3-4 月樱花季必去城市东京、京都、大阪预算参考中档消费每天 200-300 美元住宿需提前 3 个月预订到达前购买 JR Pass高分餐厅Sushi Dai、Ichiran Ramen、Tsunahachi Tempura。按 SKILL.md 的指引抓取时应带着事实提取的目的去读事实、数据、主张、约束条件、日期等都要逐条记录并为每条关键事实记录来源 URL/ID供后续引用。这也是 evaluations/README.md 中验收该 Skill 的核心行为——抓取 3-5 个以上来源页并在多来源间综合是评估脚本如 basic-research.json明确要求的通过标准。3.3 第三步研究并综合Research Synthesize示例将历史旅行者的个人经验与外部调研结合形成一份完整方案所需的六大维度航班选项与价格住宿类型酒店 / 温泉旅馆 ryokan / Airbnb交通JR Pass 为核心10 天行程结构预算拆解实操贴士来源于有经验旅行者的笔记。SKILL.md 对这一环节给出三条纪律动笔前先列提纲、按主题/问题分组归纳、以证据和来源 ID 支撑结论并标记信息缺口或矛盾同时始终锚定用户目标本例是为 6 人、10 天日本行做决策与预订准备。3.4 第四步在 Notion 中创建结构化页面notion-create-pages综合完成后调用notion-create-pages将结果写入 Notion指定父页面与页面属性Notion:notion-create-pages parent: { page_id: travel-plans-parent-id } pages: [{ properties: { title: Japan Trip 2026 - March 15-25 (10 Days) }, content: [Full trip plan with itinerary, budget, tips...] }]从 technical-investigation.md 和 competitor-analysis.md 两个姊妹示例可以看到同一调用模式的可复用变体parent.page_id决定文档落在工作区哪个位置如工程文档父页、战略团队空间properties.title建议采用Research: [主题] - [日期]这类便于检索的命名参见 evaluations/README.md 的 Good 示例。四、输出样例解析一份可执行的行程计划书trip-planning.md 给出了完整的输出文档 Markdown它本身就是结构化出行文档的最佳范本各段落职责如下4.1 概览与行程标题、日期、人数、人均预算$3,000-4,000在最顶部一目了然行程按 10 天切分为东京Day 1-3→ 箱根Day 4-5→ 京都Day 6-8→ 大阪返程Day 9-10四段每段列出具体景点如涩谷、浅草寺、伏见稻荷、道顿堀、奈良东大寺与交通衔接新干线、KIX 返程航班具备直接落地执行的价值。4.2 预算拆解每人输出样例中的预算表是这份文档的决策核心完整继承如下项目预算美元/人往返机票900-1,200住宿9 晚700-1,000JR Pass7 日券280餐饮50-70/天500-700活动300-400当地交通100总计2,780-3,6804.3 关键预订清单机票提前 3-4 个月预订酒店立即预订樱花季东京住新宿 2 晚 浅草 1 晚京都住祇园 3 晚大阪住难波 2 晚JR Pass出行前 2-3 周订购餐厅提前 1 周预订Sushi Dai 等热门餐厅。4.4 实用贴士与打包清单抵达后办理 pocket WiFi 或 eSIM下载 Google Translate、Hyperdia列车线路、Tabelog餐厅日本偏现金消费可在 7-Eleven ATM 取现进寺庙、温泉旅馆、部分餐厅需脱鞋列车准点率极高不要迟到学习基础用语arigatou、sumimasen、itadakimasu打包舒适步行鞋日均 1 万步以上、薄外套3 月 55-65°F、日用背包、零钱袋、充电宝。4.5 下一步行动清单与来源文档以可勾选的 Next Steps 收尾订机票、订购 JR Pass、按东京→京都→大阪顺序订酒店、创建分摊费用表、安排群体规划电话并用mention-page url...列出全部引用来源Japan Travel Guide、Tokyo Restaurant Recommendations、Kyoto Temple Guide实现信息可追溯。五、引用规范让每一条事实都有出处输出样例中反复出现的mention-page url...Page Title/mention-page并非随意写法而是 reference/citations.md 规定的标准引用语法。该文件定义了完整的引用体系基础页面引用mention-page url...Page Title/mention-pageURL 必填、标题可选行内引用紧跟被引用信息之后多来源引用一个结论来自多个页面时并列多个 mention章节级引用整节来源于单一文档时在章节开头引用一次即可数据库与用户引用mention-database url...、mention-user url...文末 Sources 段长列表按 Primary Sources / Supporting Research / Background Context 分组。citations.md 还给出了引用频率的平衡建议——过度引用每句话都带 mention与完全不引用都不可取正确的做法是按信息块分组引用。它还提供了 Citation Validation 检查清单每个关键论断都有引用、所有 mention URL 有效、Sources 段覆盖全部被引页面、过时来源被标注、直接引用明确标出、数据来源有归属。六、格式选择何时用哪种输出模板trip-planning 最终产出了一份内容丰富的计划文档但并非所有研究需求都需要这种深度。reference/format-selection-guide.md 提供了决策树与四种格式的适用矩阵格式篇幅适用场景Research Summary500-1000 词大多数研究请求默认格式Comprehensive Report1500 词正式文档、战略决策Quick Brief200-400 词时间敏感、主题简单Comparison800-1200 词多选项对比评估决策树逻辑为是否在对比多个选项 → 是则用 Comparison是否时间敏感或简单 → 是则用 Quick Brief是否需要正式/深度文档 → 是则用 Comprehensive Report否则用默认的 Research Summary。每种格式都有独立的 format 说明与 template 文件见 reference/ 目录例如 research-summary-format.md 规定其结构为执行摘要2-3 句→ 3-5 条带证据的关键发现 → 详细分析 → 结论与下一步 → 来源引用。对旅行规划这类需要行程 预算 预订清单的完整交付comprehensive-report-format.md 或其结构化的自定模板如 trip-planning 所示更为合适若用户只想要3 月去日本该穿什么这类快速答案则 Quick Brief 是更优选择。七、评估与验收Skill 的可测试性设计仓库中的 evaluations/README.md 为这个 Skill 提供了可复现的验收框架也从侧面印证了 trip-planning 示例体现的最佳实践。其核心验收点包括搜索与综合用相关查询搜索工作区、抓取 3-5 个来源页、跨来源综合、识别模式与洞察、正确处理冲突信息格式选择按范围与深度选择 Research Summary / Comprehensive Report / Quick Brief / Comparison并一致地应用结构引用与归属为所有来源添加引用、使用mention-page标签、区分 Notion 内容与 Codex 研究结论文档质量标题清晰表明主题与日期、前置执行摘要、清晰的层级结构、可执行的洞察与建议。例如Good 验收标准明确包括Searches Notion for roadmap and Q4 and product、Fetches at least 3 different source pages、Uses Research Summary format with sections: Executive Summary → Key Findings → Details → Recommendations → Sources等可量化表述。评估文件 basic-research.jsonQ4 产品路线图研究与 research-to-database.json竞品研究入库涉及读取数据库 schema 并按 Research Type、Status、Date 等属性建页则提供了两类典型评测场景后者提示我们当目标是一个 Notion 数据库时应先用notion-fetch获取数据库结构再按属性值创建页面。八、要点总结从 trip-planning.md 及其所属 Skill 的完整文档体系可以提炼出本案例的五个关键成功要素善用历史资产notion-search让朋友的旧笔记、往年的餐厅清单成为第一手调研来源而非从零开始个人经验 外部调研结合既有过来人的实操贴士脱鞋、现金、准点列车又有航班/住宿/JR Pass 的客观数据可执行的行程与预算按天切分的行程、逐项的人均预算区间、明确的预订时间点让 6 人团队可以直接分工执行实用贴士来自真实体验出行细节eSIM、Tabelog、7-Eleven ATM比泛泛的旅行攻略更有参考价值明确的下一步用可勾选清单驱动群体协作配合文末 Sources 保证每条信息都可回溯验证。这套搜索 → 抓取 → 综合 → 落库 → 引用的方法论并不局限于旅行规划——同一 Skill 下的 competitor-analysis.md竞品定价对比、market-research.md市场研究报告、technical-investigation.md技术架构调研都复用了相同的五步链路只是输出格式与落库位置不同。读者完全可以按 trip-planning 的骨架把日本 10 天旅行替换为任意需要多源综合与结构化交付的研究课题。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考