用途
该技能用于 Notion 的搜索、获取以及有限的写入工作流,适合在用户要求查找文档、规格、笔记、会议记录、项目背景等场景下使用。
主要能力
- 搜索 Notion 页面与数据源
- 获取页面或数据源内容
- 创建页面
- 更新页面
- 移动页面
在可用时优先使用上述允许列表中的操作。写入前需先发现当前可用的创建、更新或移动工具,并仅复制其实际 schema 支持的字段。若所需写入操作不可用,不得声称支持写入。即使发现更广泛的管理或破坏性操作,也不得使用。
使用方式
请求分类
先对请求进行分类:
- 只读查找或摘要
- 明确的创建、更新或移动
保持工具工作基本静默
- 在 Notion 工具工作前最多发送一条简短确认。
- 将中间的搜索/获取推理保持在内部。
- 不要在工具仍在运行时逐步叙述“让我……”“我找到了……”或部分发现。
- 一旦有足够证据,回复真实答案;若无法完成,说明实际阻碍。
搜索 Notion
先确定实际搜索短语。Notion 搜索偏向标题,因此应搜索可能的页面或数据源标题,而不是用户的完整句子。
- 使用 1-3 个简短明确的搜索短语。
- 好例子:deployment pipeline、launch tracker、incident review
- 坏例子:how do we handle deployment pipelines for mobile releases
对于列表/报告/日历类请求,先搜索规范容器:
- 页面标题:holidays、company holidays
- 数据源标题:people calendar
最多进行一轮细化。如果第一次搜索已找到可能的规范页面或数据源,先获取它,再决定是否再次搜索。
高效获取
- 搜索仅返回排序后的页面和数据源候选。选择最佳候选,然后使用返回的 URL 或 ID 获取内容。
- 如果获取的页面明确指向内联数据源或数据库,下一步获取该数据源并基于它工作。
- 如果获取的数据源已包含回答问题所需的行和字段,就此停止并基于该结果回答。
- 当容器页面或数据源已暴露所需字段时,不要串行获取大量单独的行页面。
- 仅在获取规范页面或数据源后仍缺少少量重要字段或存在歧义时,才获取单独的行。
- 一旦有足够证据回答读取请求,停止获取并回复。
仅在用户明确要求时写入
- 先通过搜索和获取解析目标或目标页面。
- 更新或移动前先获取当前页面。
- 将变更限制在用户请求的确切标题、父级、属性和内容范围内。
- 优先使用部分更新而非完全重写。
- 成功写入后,返回生成的 Notion 页面 URL 以及变更的简短摘要。
- 如果已认证用户缺少访问权限,或写入操作不可用,明确说明并停止。
适用场景
- 查找文档、规格、笔记、会议记录、项目背景
- 对只读内容进行摘要
- 在用户明确要求时创建、更新或移动 Notion 页面
限制与护栏
- 除非用户明确要求创建、编辑或移动 Notion 内容,否则默认只读。
- 不得虚构目标、父级、属性或超出请求范围的大量内容扩展。
- 搜索结果可能是页面或数据源,不得将数据源视为不支持。
- 对于“US holidays”或“2026 holidays”等限定范围的请求,读取获取内容时应用用户的范围;若来源混合多个地区或年份,说明所做的假设。
- 如果搜索未返回可访问的匹配项,说明没有可访问的页面或数据源匹配,并指出内容可能超出用户的 Notion 权限或标题匹配不佳。
- 如果顶部结果的内容获取失败,返回最佳匹配的 Notion URL,并说明该结果无法获取以进行摘要。
- 数据库删除、schema 重新设计及其他广泛管理操作不在范围内。