travel-plan-spreadsheet-generator

travel-plan-spreadsheet-generator

将杂乱的旅行信息整理成简洁、可编辑的 .xlsx 工作簿，并采用确定的结构和务实的行程规划判断。

决策树

用户实际想要什么？

• 用户想要可编辑的工作簿、电子表格、追踪表或 .xlsx 使用此技能。

• 用户提供了 PDF、屏幕截图、笔记、预订信息、购物需求或会议限制 先尽可能提取所有信息。不要询问附件中已经回答的问题。

• 请求缺少会导致工作簿出错的重要事实 将已知障碍整理成一批简短的问题。如果之后出现实质性的新安全或正确性问题，再跟进；不要重复询问已回答的内容。阅读 references/intake-protocol.md。

• 请求存在不会妨碍推进的歧义 明确说明假设，并标出需要审核的内容。不要为了完善每个细节而暂停制作。

• 用户只想要文字说明、简单建议或轻松地聊聊行程 不要将此技能作为主要工具。

• 执行环境提供了电子表格技能或同等的本地指南 开始处理电子表格前，通过执行环境发现并加载该指南，然后应用此技能的工作簿专用规范。不要假定安装路径适用于特定机器。

快速参考

需求	阅读或运行	原因
汇总问题和重要后续事项	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. 让购物安排在整个工作簿中清晰可见。相关内容应列入「每日计划」、目的地备选清单，以及「购买清单」。
7. 只研究本次行程相关的重要事项。当未来或当前的入境规定、交通限制、药品规定、航空公司值机时间窗口或活动日期会对计划产生实质影响时，应从官方来源核实。
8. 不要悄悄掩盖矛盾。当同行者人数与预订覆盖人数不一致，且会改变当天安排时，应在「概览」、「预订」、「准备与合规」和「每日计划」中明确指出。
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 以人类可读的形式呈现确定性布局契约，供审核使用。