Notion fios init

Skill rexchengm/fios-skills/skills/notion-fios-init

FIOS 旗舰版配套 AI 技能套件（需搭配 FIOS Notion 模板使用，非开源）

Install

npx -y skills add rexchengm/fios-skills --skill notion-fios-init

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

FIOS 技能套件的「初始化」技能。买家第一次使用 FIOS Notion 技能（notion-life-capture / cascade / insights / reflection / fios-status / notion-life-system）之前，用本技能把这套技能绑定到买家自己那份 FIOS Notion 副本上。触发词：初始化 FIOS、FIOS init、配置 FIOS 技能、连接我的 Notion、绑定 FIOS、第一次用 FIOS 技能、重新初始化、换了 Notion 重新绑定、FIOS 技能没数据/报错说没初始化。也在其他 FIOS 技能因为缺 references（notion-intake-rules.json / notion-system-schema.json / fios-dimension-pages.json）而无法工作时使用。

SKILL.md

6.0 KB, as published. Nobody here has run it

FIOS 初始化（FIOS Init）

把 FIOS 技能套件绑定到买家自己那份 FIOS Notion 副本。FIOS 模板每个人复制出来的库 / 页面 ID 都不同，技能本身不含任何人的 ID——靠本技能在初始化时按买家自己的 FIOS 现场发现并生成本地配置。

全程只读买家的 Notion 结构（导出 hub 页、读 v1/data_sources/<id> 与 v1/databases/<id>）。不创建、不修改、不删除任何 Notion 数据。

何时使用

买家第一次用 FIOS 技能前。
买家换了 Notion 账号 / 重新复制了模板 → 重新绑定。
任何 FIOS 技能报「找不到 notion-intake-rules.json / schema / fios-dimension-pages.json」「未初始化」。

前置条件（先和买家确认齐全）

已拥有 FIOS 模板：买家已购买并把 FIOS 模板复制进了自己的 Notion（本技能不发模板，只做绑定）。
装好 ntn CLI 并完成 Notion 授权：
- 买家在 https://www.notion.so/my-integrations 新建一个 internal integration，拿到 token。
- 用买家自己的 token 配置 ntn（按 ntn 文档：通常是 ntn 首次运行引导，或设置其配置文件 / NOTION_TOKEN）。
- 验证：ntn api v1/users/me 能返回买家自己的 bot 用户即可。
把 FIOS 分享给 integration：在 Notion 里打开 FIOS 顶层页（「数据管理」hub 页，里面列齐了全部数据库），右上角 ••• → 「连接」/「Connections」→ 选刚建的 integration。分享顶层即可让其下所有库可读。
本机有 node、jq、python3。

⚠️ 只把 FIOS 这一份分享给 integration 就够了。本技能以 hub 页为锚、只认 hub 引用的库，买家的其他模板不会被牵连。

初始化流程

第 1 步：拿到 hub 页 URL

向买家要 FIOS「数据管理」hub 页的 URL（就是模板里那个用 callout 列出全部数据库的总览页）。浏览器地址栏复制即可，形如 https://www.notion.so/...32位十六进制...。

第 2 步：跑初始化脚本

本技能 scripts/ 在 <skills>/notion-fios-init/scripts/，底座技能在同级 <skills>/notion-life-system/。

<skills>/notion-fios-init/scripts/fios_init.zsh "<hub页URL>"

脚本依次完成（每步都有日志）：

导出 hub 页 → ~/.fios/数据管理.page.md（含全部 <database> 引用）。
只读拉取每个库结构 → ~/.fios/notion-system-structure/。
重建 notion-life-system/references/notion-system-schema.json。
重建 notion-life-system/references/notion-intake-rules.json（入库路由规则）。
结构自检 + 发现 10 个维度页 → notion-life-system/references/fios-dimension-pages.json。

<skills> = 买家装技能的目录。Claude Code 通常是 ~/.claude/skills，Codex 是 ~/.codex/skills。脚本用 ${0:A:h} 自动定位自身，一般无需手填路径。默认连直连 Notion；若买家网络需代理，export NOTION_CLI_PROXY=http://host:port 后再跑。数据目录默认 ~/.fios，可 export FIOS_DATA_DIR=... 改。

第 3 步：核对自检结果

脚本末尾会打印：

结构自检：模板期望 53 个库，你的 FIOS 发现 N 个。
- 全部命中 → ✓。
- 提示「缺少 X」→ 多半是该库没分享给 integration，或买家删过这个库。让买家在 Notion 里把缺的库（或 hub 顶层）分享给 integration 后重跑。
- 提示某库「字段差异较大」→ 可能买家改过该库结构，或 hub 误引了同名的别的库。和买家确认，必要时修正 hub 页再重跑。
维度页发现：10/10。少于 10 → 对应监管库没分享 / 没有那一行；fios-status 用到该维度时会提示补 page_id。

第 4 步：冒烟测试

让买家随口说一句记录（如「记一笔今天买菜花了 20」），或直接只读查询验证绑定：

<skills>/notion-life-system/scripts/notion_query.zsh 支出事项 3

能返回买家自己的数据即绑定成功。然后告诉买家：现在可以正常用 capture / cascade / insights / reflection / fios-status 了。

生成物（都在底座技能的 references/ 下，买家本地，不外传）

文件	作用
`notion-system-schema.json`	买家 FIOS 的完整结构（含买家自己的库 ID、字段、公式——本就是买家自己的模板）
`notion-intake-rules.json`	入库路由规则（capture / cascade 等据此填字段）
`fios-dimension-pages.json`	10 个维度页的 page_id（fios-status 据此读写状态档案）

失败排查

ntn api v1/users/me 不通 → token 没配好 / 没授权。先把 ntn + token 弄通再来。
hub 页导出 0 个 <database> → 给的不是「数据管理」hub 页，或该页没分享给 integration。
写入/查询偶发返回空 → ntn 间歇性失败，原样重跑一次通常即好（脚本内已带重试）。
缺库 / 字段对不上 → 见第 3 步；本质都是「分享范围」或「买家改过结构」，不是技能问题。
网络/TLS 失败 → 设 NOTION_CLI_PROXY 走代理后重试。

通用规则

只读绑定，绝不改买家 Notion 数据。
不臆造 ID：维度页 / 库 ID 一律靠现场发现，发现不到就如实报告、让买家补。
重跑安全：本技能可反复运行（幂等），换 Notion 后重绑即可。