メニュー
@lacolaco/notion-syncのメジャーバージョンアップを実行する。notion-syncのアップグレード、マイグレーション、バージョンアップと言われた時に使用する。新バージョンが未公開の場合はポーリングで待機する。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | notion-sync-migration |
| description | @lacolaco/notion-syncのメジャーバージョンアップを実行する。notion-syncのアップグレード、マイグレーション、バージョンアップと言われた時に使用する。新バージョンが未公開の場合はポーリングで待機する。 |
| allowed-tools | ["Read","Edit","Write","Bash(pnpm add:*)","Bash(pnpm lint:*)","Bash(pnpm build:*)","Bash(pnpm notion-sync:*)","Bash(npm view:*)","Bash(git:*)","Bash(gh:*)","Bash(sleep:*)"] |
@lacolaco/notion-syncのメジャーバージョンアップを安全に実行する。
旧バージョンの知識を全て捨てろ。 新バージョンのCHANGELOGとREADMEを全文読むまで、コード変更を一切行うな。
grep "notion-sync" package.json
現在のバージョンと、対象バージョンを特定する。
対象バージョンがnpmに公開済みか確認する。
npm view @lacolaco/notion-sync version
未公開の場合、バックグラウンドで30秒間隔・最大10分でポーリングする。
DEADLINE=$((SECONDS + 600))
while [ $SECONDS -lt $DEADLINE ]; do
version=$(npm view @lacolaco/notion-sync version 2>/dev/null)
if [[ "$version" == <target-major>.* ]]; then
echo "published: $version"
break
fi
sleep 30
done
if [ $SECONDS -ge $DEADLINE ]; then
echo "Timeout: version not published within 10 minutes"
exit 1
fi
pnpm add @lacolaco/notion-sync@<version>
インストール後、以下を全文Readする。grepでの部分検索は精読の代替にならない。
node_modules/@lacolaco/notion-sync/CHANGELOG.md — Breaking Changesを全て把握node_modules/@lacolaco/notion-sync/README.md — 新APIの仕様とMigration Guideを把握Breaking Changesの一覧を列挙し、現在のコード（tools/notion-sync/main.ts）への影響を対応付けてからコード変更に着手する。
v12→v13ではclient側で生成していた値（slug等）がNotion本体に書き戻されていないケースが顕在化した。同種の乖離が発生する可能性があれば、コード変更前に以下を実施する。
tools/notion-sync/main.ts でNotionから読み取らない、client側生成の値を洗い出す片方の同意を他方に拡大適用しない。ユーザーが「まず〜だけ」「別問題」と範囲を区切った場合、その区切りを跨ぐ実装を先行させない。
tools/notion-sync/main.tsを修正する。
変更時の注意:
asキャスト）は削除するnew Date(string)等）は変換結果のバリデーションとフォールバックを必ず実装する以下を全て通過させる。
pnpm lint
pnpm notion-sync -- --mode=all
pnpm build
--dry-run 単独は検証として不十分。 incremental modeの --dry-run は「前回差分なし」で Fetched 0 pages になりうる。その状態では新バージョンの extractMetadata / generateFrontmatter など、検証したいコードパスが一度も実行されない。
main.tsに書き込み系副作用（Notion APIへのPATCH等）を追加した場合、pnpm notion-sync 自体の破壊度が上がる。 追加前は読み取り専用だったコマンドが本番環境変更を含むようになった時点で、実行前にユーザー承認を再取得する。
--mode=all での実行後、以下を確認する:
Sync completed: { succeeded: N, failed: 0 } のNが想定件数以上git diff content/notion/posts/*.md）が期待通りのフィールド構成queryFilter、propertyOutputs、getImageOutput が正しく動作した痕跡がログに残っている「exit 0」だけで検証完了と判断しない。出力に検証対象が実行された痕跡を確認するまで次に進まない。
--mode=all は manifest.json と記事mdを実際に更新する。コミット戦略:
chore(deps): upgrade ...): package.json / pnpm-lock.yaml / main.ts / README.md のみchore: sync notion content): manifest.json / 記事md / v12で生成されなくなった既存成果物の削除移行ロジックの変更と、Notionデータ同期の副作用を別コミットに分離する。
通常のpr-lifecycleスキルに従う。