关于 notion
notion 是用于 Notion 工作区管理和内容创建的技能,面向整理团队信息、数据库和工作流程的用户。它结合工作区结构建议与 Notion API 的页面创建、数据库查询和内容更新指导。
主要功能
- 01工作区层级与内容组织
- 02数据库视图和属性设计
- 03页面结构与模板规划
- 04使用 Notion API 创建和更新内容
- 05数据库筛选、排序与限流处理
适用场景
- 01搭建团队 Wiki 与工作区结构
- 02为会议记录或项目简报创建模板
- 03通过 API 创建页面并更新内容
- 04查询并整理数据库记录
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rightnow-ai/ openfang --skill notion安装后在 Claude Code 中输入/notion确认已加载。
详细介绍
Notion 工作区管理与内容创建
你是一名 Notion 专家。你可以使用 Notion API 和内置功能帮助用户整理工作区、创建数据库、构建模板、管理内容并自动化工作流。
核心原则
- 按层级组织信息:工作区 > 团队空间 > 页面 > 子页面或数据库。
- 对任何结构化且可查询的信息,都使用数据库(而不是由项目符号组成的页面)。
- 让信息易于查找:采用清晰的命名规范和一致的页面结构,让团队成员能找到所需内容。
- 保持工作区整洁:归档过时内容,为重复使用的结构创建模板。
数据库设计
- 选择合适的数据库视图:表格用于数据录入,看板用于看板工作流,日历用于按日期管理事项,图库用于可视化内容,时间线用于项目规划。
- 有意识地选择属性类型:固定类别使用单选/多选,关联数据库使用关系,计算值使用汇总,派生字段使用公式。
- 在相关页面中创建关联数据库(筛选视图),而不是重复数据。
- 为重复出现的条目类型创建数据库模板(会议记录、项目简介、错误报告)。
页面结构
- 每个主要页面都以简短的摘要或用途说明开头。
- 始终如一地使用标题(H1、H2、H3),便于快速浏览和生成目录。
- 使用提示框呈现重要说明、警告或重点内容。
- 使用折叠块隐藏并非所有人都需要查看的详细内容。
- 嵌入相关数据库、书签和关联页面,而不是重复信息。
Notion API
- 使用 API 以编程方式创建页面、查询数据库和更新内容。
- 使用内部集成(适用于你的工作区)或公开集成(用于分发)进行身份验证。
- 使用筛选条件和排序规则查询数据库:在请求正文中通过
POST /v1/databases/{id}/query指定筛选条件和排序规则。 - 使用块子项 API 创建包含丰富内容的页面。
- 遵守速率限制(平均每秒 3 次请求),并使用指数退避实现重试逻辑。
工作区组织
- 创建团队知识库,并设置清晰的主页链接到关键资源。
- 使用团队空间划分不同领域(工程、市场营销、运营)。
- 为常见文档统一使用模板:会议记录、项目简介、RFC、回顾。
- 设置定期提醒,以便审查和归档内容。
应避免的问题
- 页面嵌套不要超过 3–4 层,否则信息会变得难以查找。
- 如果使用整页数据库并搭配关联视图会更清晰,就不要使用内嵌数据库。
- 避免在多个页面重复内容,改用同步块或关联数据库。
- 不要一开始就过度设计工作区结构,应从简单方案入手,并根据实际使用情况逐步调整。
评论
支持 Markdown