前言¶
写作工具和 Agent 直接操作笔记软件时，最麻烦的不是写不出来，而是写完还得打开网页点按钮：同步页面、筛选数据源、上传附件，每一步都在打断流程。这个 Skill 把 Notion 的页面读写和数据源查询搬到命令行，让这些动作可以在脚本或 Agent 调用里一次性完成。
先交代来源差异：任务方给出的 Skill 名称是「笔记与知识管理（notion）」，官方地址为 https://api.skillhub.cn/org-pqka8yp5/notion；已抓取到的页面资料对应的是 @org-b6kzcl68/notion，名称「Notion CLI 页面数据源操作」，发布者为重庆途光网络传媒有限责任公司，来源 enterprise，分类 dev-programming。两者同名不同坐标，本文事实以已抓取资料为准。
这是什么¶
一句话定位：基于 Notion 官方 CLI（ntn）与 API 的命令操作工作流，覆盖页面读写、Markdown 导入、数据源查询、文件上传、Workers 部署、评论、搜索和原始 API 调用。
它解决的问题是：在命令行或 Agent 流程里操作 Notion 时，不需要反复切到网页端，也不需要为每类操作临时拼请求。
优先级规则也很明确：优先使用官方 ntn CLI；仅在 ntn 不可用、或原始请求更清晰时，才回退到 curl。
核心功能¶
下面介绍已抓取资料中列出的能力，按操作对象分组。
1、页面管理：读取、创建、更新、回收页面。
2、Markdown 内容导入：把 Markdown 写成 Notion 页面内容。
3、数据源操作：解析数据源，执行查询、过滤、排序。
4、文件上传：把本地文件交给 Notion 管理。
5、Workers：部署 Workers，查看运行日志。
6、协作与检索：评论、搜索。
7、原始 API：直接调用 Notion API，用于 CLI 覆盖不到或表达更直接的场景。
安装与启用¶
已抓取资料没有给出安装命令、目录位置或配置字段，本节不做推测。可用的做法是打开官方页面核对：
https://www.skillhub.cn/skills/org-b6kzcl68/notion
页面资料显示该 Skill 带有 requires_api_key=true 标签，说明需要 API key 才能使用，具体配置字段以页面或 SKILL.md 为准。Cursor、Codex CLI、Claude Code 之间是否有启用差异，资料中未说明，本文不写。
典型用法¶
已抓取资料给出的是工作流，不是逐条命令，这里按能力分组说明调用思路。
1、页面读写与回收：
用 ntn 读取页面 → 创建或更新页面 → 必要时回收页面
2、Markdown 导入：
准备 Markdown 内容 → 通过 ntn 导入为页面
3、数据源查询：
解析数据源 → 按条件过滤 → 排序 → 取结果
4、文件与 Workers：
上传文件 → 部署 Workers → 查运行日志
5、搜索、评论与原始请求：
搜索定位目标 → 读评论 → 必要时用 curl 调 Notion API
上面每一步都优先走 ntn；只有当 ntn 不可用，或原始请求比 CLI 更清晰时，才落到 curl。
适用场景与注意¶
适合的场景：需要在脚本或 Agent 流程中批量读写 Notion 页面、按条件查询数据源、导入 Markdown、上传文件，或部署并观察 Workers 的人。
需要注意的限制：
1、需要 API key，属于有依赖的技能。
2、优先 ntn、回退 curl 的规则意味着两类问题都要能排查：CLI 侧与 HTTP 侧。
3、数据源操作依赖数据源本身的结构，解析前应先确认字段。
4、页面资料提到「如需编程开发完整工作流套件，淘宝搜索『AI灵匣』店铺获取完整版」，这条来自资料原文，是否采用自行判断。
5、任务方简介还给出了风险等级 L1、SkillHub 评分 97648、分类 knowledge-management、下载 5064 次，以及按次计费 0.01 元/次、授权由 pay.sharpdealhub.com 承载的说明。这些信息未出现在已抓取资料中，与资料的分类 dev-programming、评分 100000、下载 3856、安装 0 不一致，引用前请自行到官方页面核实。
结尾¶
这个 Skill 的价值在于把 Notion 从网页端搬到命令行：页面、数据源、文件、Workers 都用同一套 ntn 优先、curl 兜底的工作流处理，适合嵌入自动化脚本和 Agent 调用。
两个地址如下，使用时注意坐标不同：
https://api.skillhub.cn/org-pqka8yp5/notion
https://www.skillhub.cn/skills/org-b6kzcl68/notion
