Agent Skills
返回列表
📚

Notion AI 工作区

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/notion-ai-workspace。

技能介绍

它解决什么问题

知识库散落在 Notion 的页面、数据库和属性里，人工搬运到脚本、流水线或别的工具时，要么手工复制粘贴，要么自己拼 HTTP 请求、处理鉴权和分页。结果就是重复的样板代码和脆弱的集成：一次 API 变更就要重写调用层，错误处理也常常被忽略。

这个技能的价值在于把 @notionhq/client 的用法固化下来，让你直接从工作区读取和写入数据，把注意力放在「要管什么内容」上，而不是「怎么跟 Notion 通信」。

这个技能如何工作

核心能力是调用 Notion 官方 Node.js SDK 发起对任意 API 端点的请求，覆盖知识管理中最常见的读写场景：

  • 用 Client 构造客户端，SDK 内部负责签名、重试和请求格式
  • 检索页面与数据库内容，用于把文档拉进本地索引或知识管线
  • 创建和更新页面，把外部数据回写到 Notion 工作区
  • 通过 APIErrorCode 精确判断错误类型，区分限流、权限不足、资源不存在等情况
  • 借助 LogLevel 控制日志输出，方便在调试和生产环境之间切换

典型流程很直接：初始化客户端后定位到目标页面或数据库，构造请求参数，执行调用并按错误码分支处理，最后校验返回结果。不需要自己拼接 URL 或解析响应结构。

适用边界与注意点

  • 依赖 SDK 能力，受 Notion API 本身限制：不支持跨工作区访问，数据库查询也不是真正的 SQL
  • 读写权限由集成的 scope 决定，权限不足时会收到明确的 APIErrorCode，建议在代码里显式处理而不是静默忽略
  • 大量分页或批量写入时要注意速率限制，最好加上退避策略
  • 技能本身不包含业务逻辑，页面结构怎么设计、数据怎么清洗仍需你自己决定
  • 资料提取自上游文档，接口以 @notionhq/client 当前版本为准，升级前先核对 changelog

使用场景

  • 团队需要把散落在多个Notion数据库中的文档元数据同步到本地检索服务时，用Node.js脚本批量拉取数据并处理分页。
  • 自动化流水线需要把外部系统生成的周报自动写入指定的Notion页面时，调用API创建页面并写入结构化内容。
  • 知识库脚本在夜间批量更新Notion页面时遇到接口限流，需根据APIErrorCode编写重试逻辑以保障任务不中断。
  • Node.js服务需要集成Notion数据，利用该技能快速初始化Client并按LogLevel调整日志级别排查同步异常。

适合人员

  • 后端开发者：需要在Node.js服务中集成Notion数据读写能力，构建知识同步管线。
  • 数据工程师：负责把Notion中结构化与非结构化文档批量抽取到数仓或搜索索引。
  • 自动化工程师：编写脚本将外部系统产出的内容写入Notion工作区，并处理接口异常重试。
  • 技术负责人：评估和落地基于Notion API的内部知识管理集成方案。