【実務・中級編】Notionの「データベース・テンプレート」における変数（@Todayや@Me）の動的置換バグと、自動化フローが意図せず停止する原因の特定方法 – プロジェクト・ナレッジ管理活用バイブル

【Notion完全攻略】「@Todayが更新されない」「オートメーションの静的化バグ」を完全鎮圧する。タスクDBの動的テンプレート設計とAPI連携の極意

開発チームのベロシティを追求する中で、僕たちが日々向き合うツール「Notion」。直感的なドキュメンテーションと柔軟なデータベース構造は強力ですが、「テンプレート内の `@Today` や `@Me` が意図通り動かない」「オートメーションによるタスク自動生成がいつの間にか止まっている」という問題に直面したことはありませんか？

「毎朝自動作成されるはずのデイリースクラムのタスク日付が、なぜかテンプレートを作成した日（3ヶ月前）で固定されている」
「オートメーションで担当者を割り当てたはずが、実行したBot自身（あるいはテンプレ作成者）になってしまう」

これらは仕様を装った「静的置換の罠（Evaluation Snapshots）」です。本記事では、アジャイル開発現場で現場の足を引っ張るこれらの挙動をロジカルに解明し、極限まで堅牢なワークフローを構築するための設計テクニックを伝授します。

—

1. なぜ動的変数（@Today / @Me）は「固定化」するのか？

まず、Notionにおける変数の「評価タイミング（Evaluation Context）」のメカニズムを理解しましょう。ここを誤解していると、いくらテンプレートを作り直してもバグは再発します。

【誤った認識】
テンプレートを作成 → `@Today` と入力 → ページが作られる「その瞬間」の日付が評価される

【現実のメカニズム（罠）】
テンプレート作成時に「直打ちの文字列」や「カレンダー選択の固定日付」で `@Today` を埋め込む
↳ Notionはこれを「テンプレート編集時のタイムスタンプ」として静的確定（スナップショット）してしまう！

発生する3大実例バグ

① カレンダープロパティにおける「日付の固定化」

DBテンプレートの「日付プロパティ」でカレンダーから「今日」を選択して保存すると、「テンプレートを作成した日付」がハードコードされます。翌日そのテンプレートからページを生成しても、日付は昨日のままです。

② 本文（ページコンテンツ）における「@Today」の評価失敗

ページ本文に半角で `@Today` と打ち込んで補完された日付は、テンプレート作成時点の静的なテキストリンクに変換されるケースがあります。動的な相対日付として機能させるには、インラインメニューから明示的に「複製時（Date when duplicated）」を選択しなければなりません。

③ Notion Automations × テンプレート適用時の `@Me` のコンテキスト消失

Notion標準のデータベース・オートメーションで「ページが追加されたら、テンプレートAを適用し、担当者を `@Me` にする」というトリガーを組んだ場合、`@Me` は「タスクを作成したエンジニア」ではなく、「オートメーションを実行したBot（システム）」または「テンプレートを作成・所有しているユーザー」に評価されてサイレントに意図しない挙動を引き起こします。

—

2. 変数の固定化バグを根絶する「回避策と設計アーキテクチャ」

この問題を回避し、常に正確な動的置換を実現するための3つの原則を解説します。

回避策1：プロパティには「複製時（Date when duplicated）」を厳格指定する

データベーステンプレートの編集画面で日付プロパティを設定する際、絶対にしてはいけないのが「カレンダーから本日の日付をクリックすること」です。

1. 日付プロパティの入力欄をクリック。
2. ポップアップ下部にある 「複製時（When duplicated）」 （または「今日 – 複製時」）を明示的に選択する。

これで、テンプレートから新しいページが作られた瞬間のローカルタイムスタンプが即座に動的注入されます。

—

回避策2：Formula 2.0で「現在時刻」を動的算出する（最強の静的化対策）

テキストやプロパティの評価バグに依存したくない場合、Notion Formula 2.0を利用してシステム側で動的に判定させる構造を作るのが最も確実です。

例えば、「今日実行すべきタスクか？」を判定するプロパティを作成する場合、テンプレートに日付を持たせるのではなく、以下のFormulaを組み込みます。

/ Formula 2.0: 日付が今日かどうかをリアルタイム判定 /
let(
taskDate, prop(“実行予定日”),
todayStr, now().formatDate(“YYYY-MM-DD”),
taskStr, taskDate.formatDate(“YYYY-MM-DD”),

/ 作成日または実行予定日が今日に等しいかチェック /
if(
empty(taskDate),
prop(“作成日時”).formatDate(“YYYY-MM-DD”) == todayStr,
taskStr == todayStr
)
)

テキストベースの `@Today` 置換が壊れても、このFormulaプロパティはユーザーがページを開いた「現在のシステム時刻（`now()`）」を元に計算されるため、静的化バグの影響を100%受けません。

—

回避策3：外部API/Webhook経由の動的ペイロード設計

Notion内蔵オートメーションのコンテキストバグを回避し、CI/CDやGitHub Actions、n8n/Make等からタスクを生成する場合は、Notionの動的置換に頼らず、呼び出し側（実行環境）で日付と実行ユーザーIDを確定させてペイロードを叩くのがエンタープライズ領域のベストプラクティスです。

以下は、GitHub ActionsからNotion REST APIを叩き、動的置換バグを回避して完璧なタスクを自動生成するJSON payload構成例です。

{
“parent”: {
“database_id”: “YOUR_DATABASE_ID_HERE”
},
“properties”: {
“タスク名”: {
“title”: [
{
“text”: {
/ 実行環境側のタイムスタンプで動的にタスク名を生成 /
“content”: “[自動発行] 日次バッチモニタリングログ”
}
}
]
},
“実行予定日”: {
“date”: {
/ Notionの@Todayを使わず、ISO8601フォーマットで動的注入 /
“start”: “2023-10-25T09:00:00.000+09:00”
}
},
“担当者”: {
“people”: [
{
/ @Meに依存せず、API実行コンテキストに応じたExplicitなUser IDを指定 /
“id”: “c2b3e4f5-6a7b-8c9d-0e1f-2a3b4c5d6e7f”
}
]
},
“ステータス”: {
“status”: {
“name”: “To Do”
}
}
}
}

—

3. 自動化フローが「無言で停止」する原因と特定デバッグ手順

NotionのオートメーションやWebhook連携がサイレントに失敗する（エラーが出ずに動かない）場合、原因はほぼ以下の3パターンに絞られます。

[失敗原因の特定フロー]
├─ 1. 権限不足：Botインテグレーションが対象DBの「編集権限」を持っていない
├─ 2. スキーマミスマッチ：DBのプロパティ名変更・型変更によるサイレント不一致
└─ 3. セレクト値の揺らぎ：Select/Multi-Selectの文字列完全一致失敗（大文字小文字/スペース）

デバッグ時の確認チェックリスト

1. Automation Logの確認
データベースの「⚡（オートメーション）」アイコン＞「実行履歴（History）」を開き、失敗したステップのステータスコード（400 / 404 / 429）を確認する。
2. Botのアクセス権限再検証
対象のデータベースだけでなく、関連する「リレーション先データベース」にもBotのアクセス権が与えられているかを確認してください。リレーション先の書き込み権限がない場合、オートメーションは警告なしにロールバックされます。

—

4. 開発速度を爆アゲする「テックリードの秘密兵器」

ここからは、チーム全体の開発速度（ベロシティ）を劇的に高めるための具体的なツール、ショートカット、運用ルールを公開します。

① 爆速化を実現する隠れたキーボードショートカット

マウス操作を極力減らし、ドキュメンテーションとタスク管理を指先だけで完結させましょう。

—

② 現場エンジニア絶対導入の「神プラグイン/拡張機能」

1. Notion Boost (Chrome Extension)

概要: NotionのUI/UXをエンジニア向けに極限まで拡張するツール。
神機能: 左側に「目次（Outline）」を常時表示、全幅表示（Full Width）のデフォルト有効化、コードブロックの行番号表示と1クリックコピーボタン追加。仕様書を読むスピードが倍化します。

2. Save to Notion (Chrome Extension)

概要: 公式クリッパーを超えた高機能Webクリッパー。
神機能: クリップ時にNotion DBのプロパティ（ステータス、担当者、タグ等）をブラウザのポップアップ上で直接入力して保存可能。技術記事の一次情報ストックに最適。

—

③ チーム開発で絶対守るべき「Notion設定の共有化ルール」

複数人でNotionを運用すると、スキーマが散らかり、オートメーションが破損します。テックリードとして以下の3大原則をWorkspaceに適用