Notion 生产力工具

要解决什么问题

在 Agent 或自动化脚本里直接操作 Notion，往往要自己拼 REST 请求、处理分页和块类型，还要在「页面」「数据库」「Markdown 导出」之间切换上下文。本技能把 Notion API 与 ntn CLI 收敛成同一套能力描述，让模型按约定调用页面与数据库读写，而不是每次从零查文档。

技能如何工作

• 页面与数据库：通过 API 创建、更新、查询 Notion 页面与数据库记录，适合把任务状态、笔记索引挂到固定数据源上。
• Markdown：在 Notion 块结构与 Markdown 之间做内容往返，便于在本地或 CI 里编辑后再写回工作区。
• Workers：资料中标注支持 Workers 场景，适合在边缘或轻量运行时里触发与 Notion 相关的读写（具体边界以你环境中的 ntn 与 API 权限为准）。
• 环境：运行前需配置 NOTION_API_KEY，并在 Notion 集成里把目标页面/数据库授权给该集成。

适用边界与注意点

• 权限完全由 Notion 集成与共享范围决定；Agent 只能访问已授权的资源，不能绕过工作区策略。
• 数据库 schema、关联属性与富文本块在 API 层有字段限制，复杂排版可能需要拆成多次更新或先在 Notion 侧简化结构。
• 跨平台（Linux / macOS / Windows）以技能声明为准；CLI 与 API 版本变更时，以 Notion 开发者文档 为准核对行为。