家族の旅支度

家族旅行の希望を比較可能な条件にし、誰が何をいつ準備するかと、当日の休憩・撤退判断までを一つのしおりにつなぐCodexスキルです。準備の負担軽減を支援しますが、満足度や家族関係の改善を保証するものではありません。

v1の範囲

対象は国内の車または電車による日帰り・1泊2日です。一次情報の確認、候補比較、選定、詳細計画、明示承認、しおり制作、検品、希望時の公開、出発前の再確認を扱います。予約・決済・自動通知、実在の交通データを取得するAPI契約、家族間リアルタイム同期は含みません。

旅行条件・根拠・時間/予算計算・承認版はPythonハーネスで管理します。端末内チェックの状態は家族間で同期されません。担当候補は未定でもよく、性別から割り当てません。

導入と起動

ZIPを作り、インストール先を明示して新しいディレクトリへコピーします。既存ZIPや既存ディレクトリは上書きしません。グローバルスキルやCodex設定は変更されません。

python scripts/distribute.py build --out .\dist\family-trip-studio.zip
python scripts/distribute.py install --target .\installed\family-trip-studio

どちらのコマンドも、含めたファイル数と各ファイルのSHA-256 manifestをJSONで表示します。ZIPには family-trip-studio/ 以下だけを格納し、MANIFEST.sha256 を同梱します。絶対ローカルパスや典型的な秘密情報の検査は単純な文字列パターンによるものです。人の目による配布内容確認も行ってください。

配布ZIPを使う場合は、展開した family-trip-studio フォルダを ~/.codex/skills/ に置き、新しいCodex会話で呼び出します。既存の同名フォルダがあれば上書きせず、先に差分を確認してください。ソースから導入する場合はinstallのtargetにその新規フォルダを指定します。既存スキルや設定の編集は不要です。

呼び出し例: $family-trip-studio 京都駅から車で休憩込み片道90分以内。大人2人と2歳の子で日帰り、予算2万円。準備を分担して無理なく遊びたい。候補比較からお願いします。

データ形式と実行コマンドは同梱の references/data-contract.md にあります。例:

python .\installed\family-trip-studio\scripts\trip.py init .\trip-case
python .\installed\family-trip-studio\scripts\trip.py check .\trip-case --stage candidates
python .\installed\family-trip-studio\scripts\trip.py check .\trip-case --stage plan

しおり・制作・公開

計画データは既定でローカル/家族向けです。export --out <新しい出力先> で出力し、studio-siteが利用できる環境では承認済みデータを制作入口へ渡して、家族の希望に沿うリッチなしおりへ仕上げます。studio-siteがない環境では同梱のスマホ向けHTMLを使えますが、それだけで希望するリッチ品質を満たしたとは判定しません。

公開用出力は --audience public を指定します。公開版では旅行日・出発地域・家族ラベルや担当記号などを匿名化します。自由文に個人情報が残る可能性があるため、公開前に必ず内容を確認してください。noindexはアクセス制限ではありません。住所、予約番号、認証情報は計画データへ入れないでください。

公開版は匿名化した紹介・作例向けで、日付を使う期限切れ警告はありません。実際の旅行にはfamily版を使います。両版ともライブ情報の自動更新や家族間チェック同期は行いません。

確認

リポジトリ直下から実行します。

python -B -m unittest discover -s tests -v
python -B skills/family-trip-studio/scripts/trip.py --help
python -B scripts/distribute.py --help

対象日の営業・料金・経路・空き状況は変わります。確認できない情報を確定事実として扱わず、期限切れや対象日への適用が未確認の根拠では承認を止めます。出典の公式掲載を確認したことと旅行日に適用できることは別です。承認ハッシュは意図しない変更の検出用で、本人確認や改ざん防止ではありません。

開発証跡と保持

全体計画はPLAN.md、進捗とゲートはprogress.json、独立レビューと受入結果はreviews/に保存します。生成データは.runs/、配布ZIPはdist/へ出力し、画像・PDF・ZIPはGitに含めません。.runs/の検証生成物は30日を保持目安とし、必要なものを保全後に手動整理します。dist/は次の検証済み版への置換まで保持します。自動削除はしません。

配布物の検証は python scripts/verify-package.py dist/family-trip-studio-1.0.1.zip --out .runs/clean-room-new で、新規展開・ハッシュ照合・同梱例の選定から出力までを確認できます。合成例の実行は実在施設の調査やユーザー承認を意味しません。