Notion

此技能允许代理使用Notion页面和数据库通过官方的Notion API。

该技能是声明式的：它记录了安全、推荐的操作并假定有一个本地CLI (notion-cli) 来实际执行API调用。

身份验证

• 在以下地址创建Notion集成https://www.notion.so/my-integrations
• 复制内部集成令牌。
• 将其导出为：

export NOTION_API_KEY=secret_xxx

将集成分享给你想要访问的页面或数据库。 未分享的内容对API不可见。

配置文件（个人/工作）

您可以通过环境变量或配置定义多个配置文件（例如，个人、工作）。

默认配置文件：personal

通过以下方式覆盖：

export NOTION_PROFILE=work

页面

读取页面：

notion-cli page get <page_id>

附加内容块：

notion-cli block append <page_id> --markdown "..."

优先采用附加内容而非重写已有内容。

创建页面：

notion-cli page create --parent <page_id> --title "..."

数据库

检查架构：

notion-cli db get <database_id>

查询数据库：

notion-cli db query <database_id> --filter <json> --sort <json>

创建行数据：

notion-cli page create --database <database_id> --props <json>

更新行数据：

notion-cli page update <page_id> --props <json>

架构变更（高级操作）

应用架构变更前务必检查差异。

未经明确确认切勿修改数据库架构。

推荐操作流程：

notion-cli db schema diff <database_id> --desired <json>
notion-cli db schema apply <database_id> --desired <json>

安全注意事项

• Notion API存在速率限制；请谨慎进行批量操作。
• 优先采用附加和更新操作，避免破坏性操作。
• ID为不透明标识符；请显式存储，切勿从URL推断。