notion-connect

用途

Notion Connect 是一个元技能，用于实现与任意 Notion 数据库的完整工作区集成。其目标是让用户通过自然语言与 Notion 交互，例如“查询我的 Projects 数据库”或“向 CRM 添加一个页面”，无需手动调用 API、记忆数据库 ID 或查找 schema。

该技能提供十个工作流：

配置检查（Workflow 0）：每个工作流开始前必须运行配置验证脚本，根据退出码判断配置状态（0 完全配置，1 部分配置，2 未配置）。
发现数据库（Workflow 1）：查找用户 Notion 工作区中所有可访问的数据库并缓存 schema，生成 01-memory/integrations/notion-databases.yaml。
查询数据库（Workflow 2）：按名称模糊匹配数据库，支持单条件过滤（如 Status = Active）、排序和数量限制。
创建页面（Workflow 3）：根据 schema 提示用户填写必填属性，校验后创建页面并返回 URL。
管理数据库 schema（Workflow 4）：创建新数据库或添加属性，支持 title、rich_text、number、select、multi_select、date、checkbox、url、email、phone_number、people、relation 等属性类型。
更新页面（Workflow 5）：通过页面 ID 或标题搜索定位页面，修改属性。
获取/删除页面（Workflow 6）：检索页面详情或归档页面（Notion 仅归档，不硬删除）。
管理内容/块（Workflow 7）：列出、追加、更新、删除页面内的内容块，支持段落、标题、列表、代码、媒体、结构等块类型。
用户管理（Workflow 8）：列出工作区用户、获取当前机器人信息，用于 @提及和 people 属性。
评论（Workflow 9）：列出或创建页面/讨论的评论。
高级操作（Workflow 10）：计划中，包括文件上传和数据源 API。

首次使用需运行配置检查脚本：

python 00-system/skills/notion-master/scripts/check_notion_config.py

若退出码为 2（未配置），运行交互式设置向导：

python 00-system/skills/notion-master/scripts/setup_notion.py

向导将引导获取/输入 API 密钥、保存配置到 .env、获取用户 Notion ID、保存到 user-config.yaml、自动运行数据库发现并创建 01-memory/integrations/notion-databases.yaml。设置完成后即可立即查询数据库。

各工作流通过触发词激活，例如“connect notion”“query [database]”“add to [database]”等。查询、创建、更新等操作均通过调用 notion-master 共享库中的 Python 脚本完成，脚本参数和用法在资料中有详细说明。

适用于需要频繁读写 Notion 数据库、希望以对话方式管理 Notion 内容的用户，例如项目管理、CRM、内容日历、任务跟踪等。