用途：该技能面向 Notion 页面与数据库的读取、搜索、更新和整理操作，通过可用的 Notion MCP 工具完成。优先使用官方 Notion MCP 连接器；当连接器缺少所需能力或用户要求脚本时，可使用可选的 ntn CLI。
主要能力：MCP 路径可支持数据库模式 DDL、视图 DSL、块级评论、单次批量创建最多 100 行的页面，以及跨已连接来源（Slack、GDrive、GitHub、Jira、MS Teams、Sharepoint、OneDrive、Linear）的语义搜索。ntn CLI 可补充文件上传、Notion Workers/无服务器、无头/CI 非交互场景，并可用 ntn api ls 枚举 REST 端点、用 shell 管道处理数据。
使用方式：每次会话在写入前做一次 Pre-flight：读取 MCP 资源 notion://docs/enhanced-markdown-spec 以了解 Notion 风味 Markdown 规范，不要凭猜测书写语法；对数据库行 CRUD 先 notion-fetch 目标数据源获取当前模式，注意属性名大小写敏感及日期、地点、勾选等展开键规则。若 CLI 路径需要但 ntn 缺失，应打印安装与认证 URL 后停止，不要替用户自动安装。认证和连接设置需用户授权。
适用场景与限制：适用于需按实际可用工具而非客户端身份路由的 Notion 操作。写入时需保留用户授权范围并验证结果。若父级页面/数据库/数据源在回收站中，写入会以 archived ancestor 失败，而预检可能仍返回模式，因此对不熟悉的写入目标先检查被删除属性。绝不能在任何输出、日志、提交中回显 Notion API token。具体工具语法以活动会话中的工具描述为准，版本敏感的限额需在依赖前核实。