travel-plan-spreadsheet-generator

travel-plan-spreadsheet-generator

雑然とした旅行情報を、構成が一貫した、実用的な旅程計画の判断を反映する、編集可能な .xlsx ワークブックにまとめます。

Decision Tree

ユーザーが実際に求めているものは何ですか？

• 編集可能なワークブック、スプレッドシート、トラッカー、または .xlsx を求めている このスキルを使います。

• PDF、スクリーンショット、メモ、予約情報、買い物の要望、またはカンファレンスに関する制約を提供している まず、可能な限りすべての情報を抽出します。添付資料からすでに分かる内容について、質問しないでください。

• ワークブックの内容を誤らせる重要な情報が不足している 把握済みの阻害要因をまとめ、簡潔に一括で確認します。安全性や正確性に重大な影響を及ぼす新たな問題があれば追加で確認しますが、回答済みの内容を再度聞かないでください。references/intake-protocol.md を参照してください。

• 進行を妨げない曖昧さがある 明示的な前提と、確認が必要であることを示すフラグを付けて進めます。細部をすべて確定するためだけに作成を止めないでください。

• ユーザーが文章での説明、簡単なおすすめ、または気軽な旅程相談だけを求めている このスキルを主なツールとして使わないでください。

• ハーネスにスプレッドシート用のスキル、または同等のローカルガイダンスがある スプレッドシートの作業を始める前に、ハーネスを通じてそのスキルを見つけて読み込み、このスキルのワークブック固有の仕様を適用します。特定のマシンに依存するインストールパスを前提にしないでください。

Quick Reference

必要な内容	参照または実行するもの	理由
情報収集の一括確認と重要事項の追加確認	references/intake-protocol.md	質問の繰り返しや危険な推測を避けるため
一貫性のあるワークブックの仕様	references/workbook-spec.md	シートの順序、幅、セル結合、数式、配色
旅行モデルの標準フィールド	references/trip-model.md	セルに書き込む前に内部モデルを作成するため
フィールドとシートの対応付け	references/mapping-rules.md	Pack、Buy、Prep を明確に分けるため
変動しやすい旅行情報の調査ルール	references/research-policy.md	ビザ、乗り継ぎ、医薬品、カンファレンスの日程、その他変動する情報を確認するため
ワークブックの作成	python3 scripts/build_workbook.py --trip-model /path/to/model.json	.xlsx ファイルを生成するため
ワークブックの検証	python3 scripts/validate_workbook.py /path/to/output.xlsx --trip-model /path/to/model.json	構成、数式、入力規則、行のパターンを確認するため
視覚的なリスクの確認	python3 scripts/render_check.py /path/to/output.xlsx	レンダラーが利用できない場合に、文字の切れやはみ出しが起きる可能性を検出するため
パッケージとサンプルビルドの確認	python3 scripts/test_skill.py /path/to/skill	ローカルでの機能スモークテストを実行するため

運用ルール

1. 質問する前に、まず情報を抽出します。ユーザーの PDF、スクリーンショット、貼り付けられたメモ、フライト情報、ホテルの予約確認、買い物の依頼、確定済みの予定を確認します。
2. 対応を妨げる問題と、妨げない問題を分けます。判明している必須情報の不足をまとめ、安全性や正確性に実質的に影響する新たな問題が生じた場合に限り、追加で確認します。質問数の制限を守るために重要な事実を推測したり、回答済みの質問を繰り返したりしません。
3. ワークブックに着手する前に、正規の旅行モデルを作成します。templates/trip_model_schema.json と references/trip-model.md を使用します。
4. 決定的な処理とヒューリスティックな判断を分けます。
   • ファイル名の方針、シート順、セル結合、列幅、数式、入力規則、塗りつぶし、フォント、罫線、固定の行パターンには scripts/build_workbook.py を使用します。
   • 整理されていない情報の抽出、矛盾の調整、ペースの判断、買い物情報の可視化、無理のある計画の整理、別行動プランが必要な場合の判断には、適切な判断力を用います。
5. 明確な根拠がない限り、グループ全員が一緒に行動することを基本とします。グループの一部しか予約されていない場合は、予約が全員分あるかのように扱わず、別行動時の代替案と目につく確認フラグを作成します。
6. ワークブック全体で買い物の情報を見える状態にします。関連する場合は、Daily Plan、行き先候補一覧、Buy List に記載します。
7. この旅行に必要なことだけを調べます。計画に重大な影響がある場合は、今後または現時点の入国規則、交通機関の制約、薬の規制、航空会社のチェックイン時間、イベント開催日を公式情報源で確認します。
8. 矛盾を黙ってならしてはいけません。旅行者数と予約対象人数の不一致によって当日の予定が変わる場合、その不一致を Overview、Bookings、Prep & Compliance、Daily Plan に明示します。
9. ワークブックを成果物として扱います。作成後、scripts/validate_workbook.py を実行します。@oai/artifact-tool などのレンダラーが利用できる場合は、引き渡し前に目視で確認します。

受付プロトコル

メッセージと添付ファイルに必要な情報がすでに含まれている場合は、質問しません。

確認事項をまとめて尋ねる必要がある場合は、簡潔にします。以下の任意のグループ分けを参考にしてください。項目名は変更しても、空のグループは省略してもかまいません。

Required to proceed
- ...

Useful but optional
- ...

Documents or screenshots that would improve accuracy
- ...

関連があり、まだ情報が不足している場合に限り、次の項目を確認します。旅行名または目的地、開始日と終了日、出発と最終的な帰宅、都市または滞在拠点、旅行者一覧と役割、入国手続きに関係する場合のパスポートの国籍、フライトと交通機関、宿泊施設、確定済みの予約、会議や家族の予定、予算に関する配慮、旅行のペース、移動上の制約、食事制限、買い物の目標と依頼者、グループの別行動パターン、出発前と回復日の希望、出発準備に必要な作業、希望する出力ファイル名。

チェックリスト全体、対応を妨げる問題の判定方法、文言に関するルールについては references/intake-protocol.md を参照してください。

作成ワークフロー

1. ユーザーのファイルとメモから情報を抽出します。
2. 必要に応じて、判明している対応を妨げる問題を確認事項としてまとめます。情報が追加された場合も、安全性や正確性に実質的に影響する新たな問題がある場合に限り、再確認します。
3. 正規の旅行モデルを作成し、前提、情報源、確認フラグ、買い物の目的を明示的に記録します。
4. 重要な変動情報を確認します。references/research-policy.md を参照してください。
5. scripts/build_workbook.py を実行して、ワークブックを生成します。
6. 生成した .xlsx に対して scripts/validate_workbook.py を実行します。
7. @oai/artifact-tool または別のレンダラーが利用できる場合は、各シートをレンダリングして簡単に目視確認します。利用できない場合は、scripts/render_check.py を実行して、構造上の見た目のリスクを確認します。
8. 未解決の確認フラグ、前提、ユーザーが確認する必要のある事項を簡潔にまとめて、ワークブックを引き渡します。

決定論的処理とヒューリスティック処理の境界

決定論的ビルダーの責務	ヒューリスティックプランナーの責務
ブックのファイル名の方針	雑然とした PDF、スクリーンショット、メモから事実を抽出する
シートの順序と命名	矛盾する証拠がいつブロッカーになるかを判断する
セルの結合範囲、列幅、行の高さ、塗りつぶし、罫線、フォント	旅行者の人数や日付の記載に関する矛盾を調整する
列見出しと入力規則のリスト	現実的な近隣エリアのクラスターと代替案を選ぶ
数式の生成とシート間の参照	家族の計画を台無しにせず、会議や仕事の予定を優先する
ステータスの用語とチップのスタイル	対象範囲が部分的な場合に、計画を分割する必要があるか判断する
出典の記録構造	Prep、Pack、Buy のどれに含めるかを判断する
旅行の前日と翌日を含めたプランナーの期間	無理のある移動ルート、予定を詰め込みすぎた日、都市間をジグザグに移動するルートを取り除く

決定論的な処理を文章で即興しないでください。ビルダースクリプトを使用してください。

要求されたブックに、サポート対象のビルダー契約外のレイアウト、スタイル、機能が必要な場合は、その制限を説明し、適切な別のワークフローを選ぶか、範囲を限定した拡張案を提示してください。カスタマイズ用のフラグをでっち上げたり、標準のバリデーターが別のブック構造を認証すると主張したりしないでください。

出典とメンテナンス

旅行モデル、日付、数式、対象範囲のフラグ、ビルダー／バリデーターの契約は安定した状態に保ってください。変動しやすく重要な旅行情報については、引き続き必要な公式情報源の確認を行ってください。スキルやランタイムのガイダンスが不十分、古い、または矛盾している場合は、常時のブラウジングは避け、関連する公式ドキュメントや信頼できる一次情報源を参照してください。未解決の制限を報告し、サンプル旅行モデルまたは回帰テストケースを添えた、出典に基づく修正案を提示してください。メンテナンスが作業範囲に含まれる場合に限り、正規のスキルを編集してください。インストール済みのコピーを黙って更新しないでください。

読み方ガイド

タスク	参照先
ブックの正確な構造、結合、カウンター、命名規則	references/workbook-spec.md
受付時の質問、ブロッカー、重要な追加確認事項	references/intake-protocol.md
出典の検証、公式情報源の優先順位、調査対象	references/research-policy.md
正規モデルのフィールドと正規化ルール	references/trip-model.md
シートへのマッピングと分類のルール	references/mapping-rules.md
失敗パターンとアンチパターン	references/gotchas.md
移植性とスプレッドシートのランタイムに関する注意事項	references/cross-harness-notes.md

注意事項

1. 既知のブロッカーを先に抽出してまとめ、質問を小出しにするのは避けてください。新たな安全上または正確性に関わる問題があれば追加確認を行います。ブロッカーでない事項には、明示的な前提条件と確認フラグを使用できます。
2. 買い物の情報をメモ欄に埋もれさせないでください。買い物が重要であれば、Daily Plan、options bank、Buy List に反映してください。
3. Pack List を Buy List にしないでください。Pack は実際に持っていくもの、Buy は購入管理リストです。
4. 対象範囲が部分的であることを黙って受け入れないでください。フライト、ホテルの部屋、またはアトラクションのチケットが、想定される人数より少ない人数分しかカバーしていない場合は、その不一致を見える状態に保ってください。
5. 調査しすぎないでください。このルート、これらのパスポート、これらの薬、これらの予定に実際に関係する準備やコンプライアンス上のタスクだけを追加してください。

ヘルパーファイル

• scripts/build_workbook.py は正規モデルからブックを作成します。
• scripts/validate_workbook.py は構造、数式、データ入力規則、列幅、セルの結合、Daily Plan の行パターンをチェックします。
• scripts/render_check.py は、より高機能なレンダラーが利用できない場合に、軽量な視覚的リスクのスキャンを実行します。
• templates/trip_model_schema.json は正規の旅行モデル契約を定義します。
• templates/workbook_template_spec.yaml は、人によるレビュー用に決定論的なレイアウト契約を反映します。