用途：把工作成果写回 Notion 页面，是 /notion-plan（从 Notion 读需求）的反向操作。
两条写入路径：API 路径需 Notion internal integration token，不打开浏览器、几乎不占 context，但只有 workspace owner 能建 integration，且页面需加入 Connections；browser 路径无 token 时使用，沿用 ~/.playwright-cli/notion-profile 登录 session，公司型 workspace 常是唯一可行路径。NOTION_TOKEN 有值走 API，否则走 browser，可用 --via api|browser 强制指定。
主要能力：Step 0 前置检查与选路（API 用 probe，browser 用 probe-js 判断 loginRedirect、editables、blocks、标题）；Step 1 确定收件对象，未指定时用 AskUserQuestion 询问且可多选，pm／design／ops／eng 各自决定写什么、刻意不写什么；Step 2 组稿为 Markdown 暂存档，不支持表格；Step 3 强制 dry-run 过目；Step 4 写入，append 为默认，comment 仅 API 路径支持；Step 5 读回验证，browser 路径以 found、occurrences、block 数增加三项全中为唯一成功判定。
必要用法：export NOTION_TOKEN="$(tr -d '[:space:]' < ~/.config/notion/token)"；python3 "$API" probe "<notion_url>"；python3 "$API" append "<notion_url>" "$DRAFT"；python3 "$API" comment "<notion_url>" "$DRAFT"；python3 "$API" readback "<notion_url>" 15；browser 路径用 playwright-cli -s=notion eval 配合 insert-js、verify-js。
限制：永不输出 token 值；不写入 secrets 或个资；不删除、不覆写既有内容，只做 append 与 comment；browser 路径不支持 comment；写入失败默认不重试，先验证实际状态；目标页面归属不明时先问使用者。