出海助手 Notion
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9c953624/yimubiao-notion。
技能介绍
要解决什么问题
团队把周报、需求台账、出海资料都放在 Notion,但页面创建、数据库筛选和批量更新往往要反复点 UI,或在脚本里自己拼 Notion-Version、Parent ID 和属性 JSON。官方 ntn CLI 已经封装了鉴权与 Markdown 读写,却缺少面向中文场景的操作说明;本技能在保留 openclaw 原始脚本与许可的前提下,把 页面 / 数据源 / 原始 API / 文件与 Workers 的用法写成可执行的助手指引。
技能如何工作
核心是优先走 ntn,以 Markdown 为中心处理页面:ntn pages get 会把属性打成 frontmatter;创建与更新可用 --content、stdin 或在 TTY 里开编辑器。父级引用统一为 page:、database:、data-source: 形态,复杂属性仍可直接 ntn api v1/pages。数据库侧先用 ntn datasources resolve 把 database ID 解析成 data source ID,再用 ntn datasources query --filter '{...}' 按 checkbox、排序等条件取行。无 CLI 或需要手写请求时,可用 ntn api 的 path/query/header 语法,或 curl 调 https://api.notion.com/v1/... 兜底。文件上传与 Workers 管理也在技能范围内,但 Workers 依赖工作区套餐与开关。
适用边界与注意点
当前约定 API 版本为 2026-03-11;归档语义用 in_trash,不要沿用旧文档里的 archived。凭证只通过环境变量(如 NOTION_API_TOKEN)注入,不要写进仓库脚本。无头环境需同时设置版本头;多数据源的 database 在指定父级时要注意 data_source_id 与块插入的 position 规则,避免按旧版 API 假设出错。
使用场景
- 每周用 `ntn pages create` 在指定父页面下生成固定结构的周报,再 `pages update` 追加本周条目
- 迭代台账库中用 `datasources query` 按 Done 复选框筛出未完成项,导出给评审会核对
- 出海资料库已有 database ID 时,先 `datasources resolve` 再带 filter 查询多国版本页面链接
- 无 ntn 的 CI 节点用 curl 调 Notion API 归档过期页面,统一走 in_trash 语义
适合人员
- 负责出海文档治理的运营,需要把多市场页面批量创建、更新到同一 Notion 空间
- 维护产品需求库的 PM,希望用筛选查询代替在 UI 里反复切换数据库视图
- 写发布或同步脚本的工程师,要在无头环境用 token 调页面与数据源 API
- Notion 工作区管理员,需确认 Workers 能力与 Business/Enterprise 限制后再开自动化