用途：Notion 是集技术文档、关系型数据库、项目路线图与 API 集成于一体的协作工作空间。本技能面向工程知识库、程序化数据库同步、任务与冲刺跟踪、自动化报告生成等场景。
主要能力：支持关系型数据库设计、Formula 2.0 表达式、通过官方 SDK @notionhq/client 进行 API 集成、工作空间自动化与模板。可用 JavaScript SDK 查询数据库（过滤、排序）、程序化创建页面与插入区块、追加区块、编写 Formula 2.0 计算（如进度条与日期运算）。
使用方式：安装 SDK 使用 npm install @notionhq/client。初始化客户端：const notion = new Client({ auth: process.env.NOTION_API_KEY }); 查询数据库使用 notion.databases.query，创建页面使用 notion.pages.create，追加区块使用 notion.blocks.children.append。
适用场景：工程知识库（团队文档、API 设计 RFC、事故复盘）、程序化数据库同步（GitHub PR、Jira 工单、部署日志）、任务与冲刺跟踪（工程待办、里程碑路线图、冲刺看板）、自动化报告生成（定时 Lambda/工作流发布每日指标摘要）。
限制与注意事项：集成令牌应存于环境变量，仅授予特定父页面访问权限；利用 Rollup 与双向关联链接冲刺、史诗与任务；API 速率限制约每秒 3 次请求，需指数退避与抖动；超过 100 条记录需用 start_cursor 与 has_more 分页。不要在 Notion 页面存储敏感密钥；避免深层无序页面层级；避免对数千行历史数据执行无过滤查询。常见错误：object_not_found（404）需在页面连接中添加集成；rate_limited（429）需重试逻辑；Formula 2.0 语法错误需用 toNumber() 或数组语法处理类型不匹配。官方帮助中心可参考。