GENERATION SKILL

トレンドセミナー生成スキル

開催ごとの企画情報から、複製・生成・接続・検証を進める共通手順です。実装で見つけた改善を手順へ戻し、次の開催に引き継ぎます。

ダッシュボード更新

「ダッシュボード更新して」で共通仕様、開催別記録、該当する生成手順を同じ変更で同期する。

原本と表示

このスキルの2階層上がプロジェクトルート。

  • 運用データ/funnel.json：最新の共通仕様・工程・項目定義。
  • 運用データ/events/*.json：開催ごとの企画、実設定、資産、確認状態、複製元、変更点。
  • 生成スキル/trend-seminar-funnel-design/：生成スキルの唯一の原本。別フォルダに原本コピーを増やさない。
  • tools/build-dashboard.py：メイン、開催一覧・詳細、設定資料、生成スキル画面を生成する。
  • 共通/dashboard-manifest.json：原本と生成ファイルのハッシュ。

表示HTMLだけを編集しない。メインの共通図は1本。開催数に上限を設けず、各開催の設定と記録を保持する。廃止した旧枠ページは生成・公開しない。設定リンク・実装記録の見出しは開催日と用途で表示する。実設定の友だち情報名・IDは維持する。

更新方法

  • 会話、ユーザー決定、保存後記録から変更点を確定する。最新の開催データを読み、同時に更新された実績・未完事項を保持する。
  • 共通ルールの変更は funnel.json の版を更新し、該当referenceの手順と検証項目も修正する。
  • 日時・企画名・実設定・状態だけの変更は対象の開催JSONへ記録する。生成物の仕様変更は該当referenceにも反映する。
  • 新しい開催は 開催の追加と複製 に従い、直近の同タイトル・同方式から複製する。固定テンプレートを別に作らず、前回の開催を上書きしない。
  • 共通仕様を改訂しても recordedSpec や appliedSpecVersion、工程の保存・読戻し状態を自動更新しない。差分と本番適用の確認を別に記録する。
  • references/dashboard-standard.md はビルドで生成する。直接編集しない。

検証と公開

  • python3 tools/build-dashboard.py、python3 tools/build-dashboard.py --check、python3 tools/verify-dashboard.py を実行する。
  • 開催追加、他開催の不変、共通仕様の差分、全開催の項目一致、リンク、スキル原本の表示ハッシュを確認する。
  • UI変更時は開催一覧の検索・絞り込み、詳細、図のモーダル、生成スキル、廃止URLの404、スマホとダーク表示をブラウザで確認する。
  • 公開を含む依頼では既存 .vercel/project.json の公開先を使い、公開manifestとローカルの一致を確認する。
  • Cloudflare Pagesへの移行時は python3 tools/prepare-cloudflare-pages.py で QA/cloudflare-pages-bundle/ を作る。生成物、CSS・JS、ダウンロード用Markdownと旧開催の参照資料だけを含め、全内部リンク、生成ハッシュ、25 MiB制限、旧枠URLの404を確認する。出力先が既にある場合は --output でQA内の新しいフォルダを指定する。公開後はCloudflareのmanifestと主要URLを読戻し、移行先を確定してから本節とプロジェクトの公開先指示を更新する。
  • 生成スキルの公開更新では、入口・全参照文書・ダウンロードできるMarkdown原本を同じ版へ揃える。開催固有値は開催記録へ置き、公開画面と原本のハッシュ一致を確認する。
  • trend-seminar-view の総合ハブと codex-seminar-funnel は別サイト。片方の反映を両方の反映と報告しない。
  • Codex.sitesへの反映を依頼された場合は、上記の生成・検証後に python3 tools/package-sites-dashboard.py で codex-sites-dashboard/dist/ へ表示ファイルを複製する。生成HTML、共通CSS/JS、参照先と生成スキルのMarkdown原本が揃っていることを確認し、Sitesの保存版と公開状態を読戻す。Codex.sitesとVercelは別の公開先として報告する。

ダッシュボード更新だけでLステップの本番設定、配信予約、顧客への送信を新たに実行しない。元の依頼で承認済みの範囲は引き継ぐ。記録確認日、本番読戻し、実発火、予約・公開を区別し、未確認は残す。

人間向け画面の生成と保持

  • メインと各開催詳細の図は displayFlow の同じ12ノード・エッジから各ページ1本を生成する。モーダルはタグ、友だち情報、Lステップ設定URL、LP URLの4項目を基本とし、個別相談終了後には配布特典も追加する。
  • 各開催はタイトル・日時の直後へ図を置き、既存の17工程・件数・状態・原記録・締切・適用記録は直下に保持する。flow-* と既存工程IDを分離する。
  • 媒体・LP導線の曖昧な対応は displayResources で明示する。イベント実値を他開催へフォールバックしない。複製時に実値を引き継がない。
  • calendar-source.json は正本の表示日程の取得スナップショット。取得日時を原サイト更新日時と呼ばず、未掲示なら日程更新日（取得・反映）として表示する。未設定日程にも空の4項目と同じ図を生成する。
  • calendar-source.json の sourceURL は取得当時のVercel URLとして保持し、画面上の現行日程リンクは currentURL を使う。移行先の変更時は実際に開けることを確認してから差し替える。
  • 検証では全図の12ノード・エッジ一致、4項目、日程全件、既存17工程記録の無損失、独立性、設定URLと実LPの分類を確認する。

ポップアップの読みやすさ

括弧内の補足は項目の次の行にグレーで表示する。元のタグ名・保存記録は改名しない。最新図には旧枠の状態名を出さず、過去記録は下段に保持する。照合キーは一斉配信_種別への代入値と対応クリックタグを併記する。KITとMyASP共通項目に確認日・subscriber由来の補足を繰り返さない。SEOには申込フォーム設定を重複掲載せず、フォームのボックスから参照する。

配布特典は回答後アクション本文と経路条件を確認して名称・URLを記録する。セミナー参加後と個別相談参加後のアンケートを混同しない。

予約完了タグの同期

タグの役割は funnel.json の tagDefinitions.seminarReservation、開催ごとの実IDは開催JSONの tagBindings.seminarReservation が原本。フォームとリマインドの共通図には文字列を重複記述せず tagRole を指定する。改名を明示依頼された場合、同じIDの保存後名を現行タグ欄と役割定義へ反映し、旧名・旧補助タグ・参照先の確認は履歴として保持する。recordedSpec・当時の件数・旧検証日・本番適用版は更新しない。

検証は正本名・ID・管理URLの一致、フォームと表示の役割参照、旧補助タグとの区別、他開催ID混入、次回作成時のID初期化を含む。ローカル検証合格を本番参照や実発火の合格と読み替えない。

全開催共通の申込済みタグの同期

funnel.json.tagDefinitions.trendSeminarRegistrant を TS-申込済み の名前・ID・管理URL・意味・確認人数の原本とする。共通図の申込フォームには開催別正本と共通タグを同時表示し、メイン画面と集計方法には「全開催の申込経験者であり開催別集計に使わない」ことを明記する。開催JSONの過去 stages.form.tags は開催別正本の履歴として一括書換えしない。

共通タグの変更では、tag_contract.py と verify-dashboard.py で固定名・ID・管理URL、フォーム内の役割参照1件、リマインドへの誤利用なし、全共通図への表示を検証する。既存参加者への一括付与件数とユニーク人数は個人情報を除いた実装記録へ残し、フォーム保存・読戻し・実回答を別状態で記録する。

タグフォルダ運用の同期

funnel.json の tag-organization を共通仕様の原本とし、タグを使う工程の ruleIds から表示する。開催JSONには企画別フォルダID、個別タグID、アクションの指定方式、保存後読戻し、旧フォルダの件数と削除有無を事実として記録する。

新開催は1開催1フォルダとし、単一タグ専用フォルダを新設しない。既存開催を移行した場合は、個別タグ指定への置換と保存後読戻しを先に行い、タグ移動後の企画別フォルダ件数と旧フォルダ0件を記録する。終了済み開催で名称変更だけを行った場合は、【終了・後にまとめます】 の件数、既存参照を維持したこと、未統合であることを区別して表示する。

集計方法と改修状況

  • 左メニュー「数値の集計方法」は funnel.json.aggregation を原本に生成する。開催別の正本タグは開催JSONから参照し、集計方法ページと開催詳細へ同時表示する。詳細は 集計方法の管理。
  • 保存台帳・レビューの差分は shared-assets.json の dashboardReview、verification、pending に記録する。開催への関係は eventKeys で明示する。保存完了・承認済みの作業指示・実発火・公開完了を混同しない。
  • 共通図の共有設定URLは displayFlow.nodes[].sharedAssetKeys、共通LPは同 lp から描画し、過去開催のモデルURLを最新の共有設定として出さない。
  • 共通図の開催別モデルURLは displayFlow.modelEventKey が指す開催JSONの実設定リンクから描画する。2026/09/28時点のモデルは9/27開催。モデル開催で対象外・リンク未記録の工程は別開催のURLで補完せず「未設定／記録なし」とする。共有設定URLは引き続き sharedAssetKeys の原本を使う。
  • 別タスクが継続中なら最新の保存記録を再確認し、未完を完了にしない。過去開催の実績や適用済み版を一括上書きしない。

原本：references/dashboard-update.md
この画面は原本から生成されています。