WorkBuddy旅行社应用之定制行程
从 Skill、Markdown、HTML 到定制行程的制作、修改与发布
小狼
旅游业从业 14 年
自媒体运营专家
目前专注于旅业人效研究与企业 AI 落地
应用和学习 AI，是为了解决问题，不是为了学习本身
先认识自己真正要解决的需求，再认识可以使用的 Skill，最后选择 HTML 这样的媒介把结果交给客户。顺序反了，就容易学了一堆功能，却仍然做不出能用的东西。
需求：客户为什么要定制、需要多快拿到、哪些信息绝不能错。
工具：把经验、步骤、停止条件和验收标准固定下来。
媒介：把结果变成客户能打开、看懂、核对和继续沟通的页面。
今天的目标
从零开始制作满足需求的工具，再让这个工具通过合适的媒介完成展示与交付。
翻译成人话：客户定制行程要“快、准、好、优”
再把学习路线摆在桌面上
你不是来学一堆英文缩写，也不是来背代码。你要解决的是一个非常具体的问题：客户问你“这趟到底怎么走、住哪里、多少钱、包含什么”，你能不能在不漏信息、不说错话的前提下，尽快给出一份看得懂、愿意看、方便转发的定制行程。
方向。谁看、要做什么决定、哪些信息绝不能错，决定工具怎么设计。
工具。把工作步骤、判断标准和输出要求写成可重复执行的说明书。
媒介。Markdown 把内容写清楚，HTML 把内容展示清楚。
结果。不是一段代码，而是一份客户拿到后能理解、能核对、能继续沟通的资料。
今天的目标，不是“会让 AI 写网页”
真正的目标是：做出一套满足旅行社真实工作需要的工具，并用合适的媒介把结果交给客户。AI 可以加快整理和排版，但不能替你决定哪一个价格是真的、哪一家酒店已经确认、哪一条退改规则适用于这张订单。
准确 ＞ 快速 ＞ 美观
错得很漂亮，仍然是错。慢一点但信息可靠，才有继续优化速度和视觉的价值。
四部分目录
认识 Skill
从“临时交代”走到“可反复执行的工作说明书”。
02认识 Markdown 与 HTML
先把内容写清，再把内容展示清。
03制作行程 HTML Skill
用事实账本、停止条件和模板，把经验装进工具。
04用 WorkBuddy 修改与发布
上传、生成、核对、修改、备份、发布，一步不漏。
使用方法
第一次按 01 → 04 顺序读，并亲手完成每章末尾的行动。以后再遇到问题，直接从左侧目录跳到对应章节。代码块和提示词右上角都能复制。
认识 Skill
Skill 不是神秘插件，也不是把 Prompt 写得更长。它是让 AI 在合适的时候，按你的方法完成一类工作的可复用说明书。
先说结论：Skill 是“岗位说明书 + SOP + 工具索引”
把 AI 想成一个聪明、肯干、但刚入职的同事。普通 Prompt 是你今天站在工位边临时交代一次；Skill 是写进工作手册的固定做法：什么任务该启动、先看什么、遇到什么情况必须停、最后交付什么。
一个旅行社场景就能看懂
临时交代
“把这份行程做成好看的网页。”AI 不知道哪些字段必须保留、价格冲突怎么办、手机端怎么验收。
固定工作法
先读完所有资料，建立事实表，核对日期与报价；缺失可出预览，冲突先停；最后生成响应式 HTML 并检查手机与打印。
两句话的差别，不在字数，而在有没有把经验变成可以执行、可以检查、可以复用的步骤。
Prompt、Skill、专家、连接器、MCP 怎么分
| 概念 | 它解决什么 | 旅行社例子 | 容易误会的地方 |
|---|---|---|---|
| Prompt | 告诉 AI 这一次要做什么 | “把这份 6 天行程做成网页” | 临时输入不等于稳定流程 |
| Skill | 规定一类任务怎么做、怎么验收 | 旅游定制行程 HTML 生成规范 | 可长期复用，不等于永远不用更新 |
| 专家 | 提供某个领域的角色、经验和判断方式 | 旅行产品经理、行程设计顾问 | 专家懂业务，不一定自带文件处理工具 |
| 连接器 | 授权 AI 访问外部软件或数据 | 读取飞书文档、写入在线表格 | 连接器管“能接到哪里”，不是业务流程本身 |
| MCP | 用统一协议向 AI 暴露工具和资源 | 查询库存、酒店或企业内部系统 | 技术能力更强，也需要更严格的权限管理 |
AI 怎么知道该用哪个 Skill
常见的 Skill 系统采用渐进式读取。AI 不会一开始把所有技能和附件全文塞进上下文，而是先看一张“技能清单”，匹配到相关任务后，再读取完整说明和必要资源。
这对你写 Skill 有两个直接要求
- description 必须写清触发场景。“旅游工具”太模糊；“当用户提供旅游行程、报价或参考网页，并要求生成完整响应式 HTML 时使用”更容易被正确匹配。
- 资源必须在 SKILL.md 里被明确指向。模板放进文件夹不等于 AI 一定会用。要写清“生成前读取 templates/itinerary.html”。
完整执行链
一个 Skill 里到底放什么
最小 Skill 只有一个 SKILL.md。任务变复杂后，再按需要加入参考资料、模板和脚本。不要为了显得专业而创建空文件夹。
travel-itinerary-html/
├── SKILL.md
├── references/
│ ├── itinerary-fields.md
│ └── fact-check-gates.md
├── templates/
│ └── responsive-itinerary.html
└── scripts/ # 可选
└── validate-itinerary.pySKILL.md
告诉 AI 何时使用、要读什么、按什么步骤做、何时停止、输出什么、怎么验收。
references/
放字段定义、业务规则、写作标准、案例说明。长资料按需读取，避免每次都占满上下文。
templates/
放网页骨架、报告模板、配置样例。AI 以它为起点修改，而不是每次从零猜版式。
scripts/
放重复且适合确定性执行的检查，例如统计行程天数、检测重复日期。脚本能减少波动，不保证输入永远正确。
SKILL.md 由两部分组成
--- name: travel-itinerary-html description: 当用户提供旅游行程、报价、需求单或参考 HTML，并要求生成完整响应式行程网页时使用。 --- # 旅游定制行程 HTML 先完整读取全部来源，核对日期、人数、价格、酒店、交通、费用范围和退改政策。 资料缺失时可以生成“预览版”；资料冲突时停止并列出冲突。 只有关键字段全部确认后，才允许标记为“可发布”。
三根短横线之间是元数据，最重要的是 name 和 description。下面是执行正文：它应该像一份能落地的 SOP，不是口号。
Claude 与 WorkBuddy：共同原理，平台细节不同
| 项目 | Claude / Claude Code 教程常见写法 | 本教程采用的 WorkBuddy 写法 |
|---|---|---|
| 项目级目录 | 常见于 .claude/skills/ | 可在技能市场创建或上传本地技能包；开放平台结构以官方说明为准 |
| 入口 | SKILL.md | SKILL.md |
| 补充资源 | references、assets、scripts 等 | references、templates、scripts 等；本地包若有既有约定，以实际版本为准 |
| 安装与启停 | 由对应 Claude 产品管理 | 技能市场中上传、查找、创建；已安装技能可启用或关闭 |
装 Skill 之前，先看它会动什么
Skill 可能读取文件、运行脚本、调用第三方服务，也可能把你输入的内容发送给外部系统。对旅行社来说，客户姓名、手机号、证件信息、未公开价格和合同条款都不能因为“装个工具试试”而失去控制。
- 来源是否明确：官方、可信作者、自己或团队维护。
- description 是否与真实功能一致，有没有故意写得模糊。
- 是否包含 scripts；脚本会读取、写入或上传哪些内容。
- 是否要求登录、密钥、浏览器权限或敏感文件夹。
- 先在测试资料和独立文件夹中运行，不拿真实客户数据试错。
- 只启用当前任务需要的技能，降低误触发概率。
WorkBuddy 中常见的三条入口
上传技能
你已经有一个本地 Skill 包时，进入技能区域，选择“添加技能 → 上传技能”，导入包含 SKILL.md 的完整技能目录或压缩包。
查找技能
描述你想完成的任务，让 WorkBuddy 搜索现有技能。安装前仍要看来源和权限。
创建技能
用自然语言说清使用场景、输入、步骤、输出和验收，让 WorkBuddy 先生成初版，再用真实案例测试。
五个常见误区
| 误区 | 为什么有问题 | 正确做法 |
|---|---|---|
| Skill 一次配置永久正确 | 业务、平台和资料格式会变化 | 版本化、测试、定期更新 |
| 脚本输出一定 100% 正确 | 错误输入和环境异常仍会传导 | 脚本结果也要验证 |
| 越长越专业 | 规则互相打架，重点被淹没 | 入口短而明确，细节放 references |
| 把所有 Skill 全开 | 模型更容易误选或调用无关能力 | 只启用当前任务所需能力 |
| 复制别人 Skill 就能用 | 别人的输入、标准和风险与你不同 | 用自己的真实流程改造 |
本章行动：写一张最小 Skill 卡
不要先写代码。只回答五个问题：什么时候使用？必须输入什么？按哪五步执行？遇到什么情况必须停？最后拿什么来验收？第三部分会把这张卡扩成完整旅行行程 Skill。
--- name: itinerary-checker description: 当用户提供旅游行程并要求检查完整性或错误时使用。 --- # 行程检查 Skill ## 输入 - 一份行程或报价资料 - 已知的客户人数、日期和预算 ## 工作步骤 1. 读取全部资料 2. 核对日期和天数 3. 核对酒店、交通和价格 4. 列出缺失与冲突 5. 输出检查结果 ## 停止条件 同一字段出现不同值时停止，不替用户选择。 ## 输出与验收 输出“通过 / 待补充 / 有冲突”，并给出对应证据。
认识 Markdown 与 HTML
Markdown 负责把内容和规则写清楚，HTML 负责把结构、视觉和交互展示清楚。它们不是竞争关系，而是同一条工作流的上下游。
Markdown 给 AI 看，HTML 给人看
在这套工作流里，Markdown 主要承载规则、知识和结构，让 AI 清楚“应该怎么做”；HTML 主要承载版式、图片和交互，让客户清楚“这趟行程是什么”。
这不是技术上的绝对限制：人也能阅读 Markdown，AI 也能读取 HTML。它强调的是分工——先用 Markdown 固定方法和内容，再用 HTML 完成对外展示。
Markdown：先把内容写清楚
Markdown 是一种用少量符号标记标题、列表、链接和代码的纯文本格式。它适合写 Skill、规则、行程初稿和资料说明，因为人能直接读，AI 也容易理解。
# 小兴安岭 6 天 5 晚 ## D1 哈尔滨集合 - 交通：机场至市区 - 住宿：酒店名称 - 提醒：抵达时间待确认 ## 费用包含 1. 行程所列住宿 2. 已确认的门票与体验
这些符号不是“排版特效”，而是在告诉读者和 AI：哪句是标题，哪组内容属于同一个清单。Markdown 很适合做内容底稿，却不擅长精细控制封面、颜色、路线图、移动端菜单和打印分页。
| 需求 | Markdown 是否合适 | 原因 |
|---|---|---|
| 写 Skill 规则 | 很合适 | 结构清楚，便于版本管理 |
| 整理每日行程 | 很合适 | 标题和清单足够表达 |
| 做客户可视化行程 | 不够 | 难以精细控制品牌、布局和交互 |
| 做打印版网页 | 需要转 HTML | HTML/CSS 能控制分页与视觉 |
HTML：一张会工作的电子纸
HTML 不是图片。它由文字、结构和链接组成，可以根据屏幕宽度重新排版，也可以配合 CSS 变得清晰美观，配合少量 JavaScript 实现目录、复制和折叠。
骨架
这是什么：标题、段落、表格、图片、章节、链接。
外观
它长什么样：颜色、字号、间距、布局、手机和打印样式。
动作
它能做什么：复制提示词、打开菜单、计算阅读进度。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>小兴安岭 6 天 5 晚</title>
<style>
body { font-family: system-ui; line-height: 1.8; }
img { max-width: 100%; height: auto; }
</style>
</head>
<body>
<h1>小兴安岭 6 天 5 晚</h1>
<p>这里放经过核对的行程简介。</p>
</body>
</html>你不需要会写代码，但要会看五个位置
<title>：浏览器标签上的名字。<h1>：页面主标题，通常只能有一个最重要的主标题。:root或 CSS 变量：常用颜色、间距和页面宽度集中放在这里。<img src="..." alt="...">：图片地址和图片说明。<a href="...">：链接去哪里；没有真实地址，不要做“立即咨询”假按钮。
为什么选择 HTML：它和 Word、Excel、H5 有什么不同
Word 擅长写文档，Excel 擅长管理数据，通常所说的 H5 擅长移动端传播；HTML 的优势，是可以把内容、视觉、导航和少量交互装进一个可编辑页面，同时兼顾电脑、手机和打印。
| 媒介 | 最擅长什么 | 做定制行程的优势 | 主要限制 |
|---|---|---|---|
| Word | 长文编辑、审阅、打印 | 销售和计调容易修改，正式文档习惯成熟 | 手机阅读体验一般，复杂视觉和交互受限，不同设备可能重新排版 |
| Excel | 报价、计算、清单和数据维护 | 适合核价、分项计算、资源和库存管理 | 不适合讲完整旅程，客户在手机上阅读困难 |
| 通常所说的 H5 | 移动端活动页和传播 | 手机体验好，动画和互动形式丰富 | 常依赖制作平台与云端服务，后续编辑、导出和长期保存受平台影响 |
| HTML | 结构化网页展示 | 响应式、可离线、可打印、可复制归档，也能发布成链接 | 仍需模板与浏览器验收；单个静态页面不能代替实时库存、下单和账户系统 |
为什么这次还选择“单文件 HTML”
单文件 HTML 把结构、样式、脚本，甚至图片都装进一个文件。双击即可打开，复制和归档简单，很适合教程、方案和定制行程。代价是文件可能较大，图片更新时也需要重新保存整个文件。
| 形态 | 优点 | 限制 | 适合场景 |
|---|---|---|---|
| 单文件 HTML | 易传、易存、离线可读 | 图片多时文件较大 | 定制行程、报告、教程 |
| HTML + assets | 素材可单独替换 | 移动文件时容易漏资源 | 需要持续维护的网页 |
| HTML + CSV | 页面与数据分开维护 | 需要更清楚的数据结构 | 库存、订单、持续更新的看板 |
| 带后端的网站 | 支持账户、实时数据、复杂业务 | 开发、部署和维护成本高 | 正式业务系统 |
响应式不是“手机上缩小”
电脑端可以并排展示路线与摘要，手机端要改成单列；宽表格应在自己的容器里横向滚动，不能把整个页面撑出屏幕；按钮要够大，长链接要能换行，正文不能小到需要放大。
看全局
目录、概览、价格和路线可以利用更宽空间并排呈现。
看顺序
最重要的信息先出现，模块单列，导航收起，触控区域清楚。
看分页
隐藏网页按钮，保留事实与来源，避免表格、截图和标题断裂。
本地文件、localhost 和公开链接不是一回事
| 地址类型 | 谁能打开 | 典型表现 |
|---|---|---|
file:///... | 通常只有这台电脑 | 本地 HTML 文件 |
localhost:... | 通常只有运行服务的设备 | 本地开发预览 |
workbuddy.link/p/... | 开启发布后，获得链接的人 | WorkBuddy 轻量发布 |
一个完整行程网页应该回答什么
客户不是来欣赏前端技术。他需要做决定。页面结构应该跟着决策顺序走，而不是跟着你手里的素材顺序走。
- 这是什么：目的地、天数、日期、人数、出发地、行程性质。
- 怎么走：线路总览、每日移动与关键体验。
- 住哪里：酒店、晚数、房型和替代规则。
- 多少钱：总价、人均或报价条件，哪些已含、哪些另付。
- 有哪些边界：车程参考、房态车态、天气替换、退改与健康要求。
- 下一步做什么：确认日期、人数、房型和联系方式；没有真实联系方式就不要放假按钮。
常见破版与修法
- 整页左右滑动：通常是宽表、固定宽度图片或长链接把页面撑开。
- 手机字太小：不是“适配”，只是把电脑页面缩小。
- 图片打开后丢失：使用了只在自己电脑存在的本地路径。
- 打印时半张表被截：没有为打印单独处理宽度与分页。
- 按钮看起来能点但没反应：没有真实功能就应该改成说明文字。
本章行动：看懂一个现有 HTML
用文本编辑器打开一个行程 HTML，找到主标题、价格、一个图片地址、一个链接和 CSS 颜色变量。不要修改，先确认自己能说清这些位置分别控制什么。
制作旅游定制行程 HTML Skill
这一部分不从“写个好看的网页”开始，而从业务需求、事实来源和停止条件开始。先把不会错的骨架搭起来，再追求效率和设计。
先问清楚：这份行程交给谁、帮他决定什么
同一份资料，可以做成内部核价表、客户确认版、销售长图或正式合同附件。读者不同，信息顺序、语气和风险完全不同。本教程默认做的是客户确认与沟通用的完整响应式行程网页。
小兴安岭 6 天 5 晚
资料包含长篇产品介绍、每日行程、住宿、价格、费用包含与不含、报名须知和退改政策；另有参考 HTML 与既有销售卡，适合演示“资料很多、说法可能冲突”时怎样保持准确。
来源资料，不是实时产品报价
案例中的日期、酒店、价格和项目只用于讲解信息整理方法。真正发给客户前，仍需按当次订单重新确认。
把需求写成一句能验收的话
输入包里放什么
| 材料 | 是否必需 | 它解决什么 | 使用前检查 |
|---|---|---|---|
| 详细行程或报价单 | 至少有一种 | 提供每日安排、价格、服务范围 | 版本和日期是否最新 |
| 客户需求 | 强烈建议 | 人数、日期、预算、房型、偏好与禁忌 | 是否包含敏感个人信息 |
| 参考 HTML | 可选 | 提供版式、颜色和模块顺序 | 只学样式，不照搬旧行程事实 |
| 图片 | 可选 | 目的地、酒店、体验展示 | 授权、清晰度、内容是否对应 |
| 业务规则 | 强烈建议 | 退改、报价有效期、替换和免责边界 | 适用于哪条产品、哪个日期 |
不要边读边设计：先建四张内部清单
AI 最容易犯的错，不是不会写 HTML，而是在资料还没理清时就开始“让页面完整”。一旦错误进入标题卡、价格卡和行程时间线，读者会因为版式整齐而更容易相信它。
每份资料是什么
文件名、版本、用途、权威性、是否为参考样式、是否包含实时事实。
每个关键值从哪来
字段、值、来源、状态。没有来源的数字不能悄悄进入客户页面。
客户需要看到什么
封面、速览、每日行程、住宿、报价、包含不含、退改、提醒、咨询。
哪些说法互相打架
同一酒店评分、价格、日期、晚数或费用范围出现不同版本时，先列出来，不替用户猜。
事实账本示例
| 字段 | 值 | 来源 | 状态 | 页面处理 |
|---|---|---|---|---|
| 行程天数 | 6 天 5 晚 | 行程标题 + D1–D6 | 一致 | 可进入封面 |
| 出行人数 | 4 大 2 小 | 参考 HTML | 明确 | 作为教学示例 |
| 总价 | ¥19,180 | 参考 HTML | 需按订单复核 | 仅标为示例报价 |
| 酒店评分 | 同一资料出现两个数值 | 长篇素材不同段落 | 冲突 | 不进入页面，先确认 |
| 联系人 | 未提供 | 无 | 缺失 | 预览可占位，不做假按钮 |
三种状态，三种动作
可以写
多个来源一致，或权威来源明确，写入正式页面。
可以预览
在内部预览中清楚占位，不伪装成正式信息。
必须停止
列出不同说法及来源，请负责人选择，不能用“看起来更合理”的那个。
先规定结果长什么样，再让 AI 动手
没有输出契约，AI 容易把资料剪成一堆好看的卡片，却漏掉客户最需要核对的条件。本教程的 Skill 固定保留九个区块：
- 封面：目的地、天数、日期、人数、行程性质。
- 行程速览：起止城市、主要停留地、移动节奏。
- 每日详情：交通、上午/下午/晚上、餐食、住宿、提醒。
- 住宿：酒店、晚数、房型、早餐、替代规则。
- 费用：总价或计价条件、适用人数、有效期。
- 费用包含与不含：一项一项对齐，不用“等”字糊过去。
- 退改与风险：取消规则、天气、房态车态、健康和年龄限制。
- 亮点：只能从已确认事实中提炼，不补编“独家”“唯一”“顶级”。
- 下一步：告诉客户还要确认什么；有真实咨询方式才放可点击入口。
预览版与可发布版
| 项目 | 内部预览 | 可发布版 |
|---|---|---|
| 关键缺失项 | 允许清楚标注“待确认” | 必须清零 |
| 资料冲突 | 停止生成并列出冲突 | 必须已解决 |
| 联系方式 | 可写“确认后补充”，不可做假按钮 | 必须是真实可用入口 |
| 图片 | 可缺省 | 确保授权、加载和内容对应 |
| 状态标识 | 醒目标注“内部预览” | 不得残留制作状态 |
把工作法写进 SKILL.md
下面是一份可以直接作为起点的 WorkBuddy Skill 说明。为了避免伪造署名，author 保留为明确模板值；真正打包前要替换。
--- name: travel-itinerary-html display_name: 旅游定制行程网页生成 display_name_en: Travel Itinerary HTML description: 当用户提供旅游行程、报价单、需求单、参考 HTML 或图片，并要求生成、整理或美化完整响应式旅游定制行程网页时使用。适用于客户沟通版行程，不用于替代合同或实时库存系统。 description_zh: 将旅游行程与报价资料整理为准确、响应式、可打印的完整 HTML 网页。 description_en: Turn itinerary and quotation materials into an accurate, responsive and printable HTML page. version: 1.0.0 author: your-name-or-team --- # 旅游定制行程 HTML ## 目标 把用户提供的行程、报价与客户需求整理为完整 HTML。 判断顺序固定为：准确 > 快速 > 美观。 ## 必须读取 开始生成前读取： - references/itinerary-fields.md - references/fact-check-gates.md - templates/responsive-itinerary.html ## 输入 至少需要下列一种业务资料：详细行程、报价单、客户需求单。 可以同时接收 Word、Excel、PDF、Markdown、纯文本、参考 HTML 和图片。 参考 HTML 只提供结构与视觉方向，不覆盖新资料中的事实。 ## 工作流程 1. 完整读取全部输入，不边读边设计。 2. 建立来源清单：名称、版本、用途、权威性、读取限制。 3. 建立事实账本：字段、值、来源、状态。 4. 建立冲突清单：日期、人数、价格、酒店、交通、费用范围、退改等不同说法。 5. 有冲突时停止，逐项列出来源和不同值，请用户确认，不自行选择。 6. 只有缺失、没有冲突时，可以生成内部预览，并把关键缺失项清楚标为“待确认”。 7. 按模板生成封面、速览、每日行程、住宿、费用、包含/不含、退改与风险、亮点和下一步。 8. 核对事实、结构、桌面端、约 390px 手机端和打印样式。 9. 输出 HTML 路径和发布检查结果。 ## 事实规则 - 不编造日期、价格、酒店、房型、车程、餐食、门票、保险、退改、联系方式或服务承诺。 - 不把参考网页中的旧事实复制到新行程。 - 不把模型推断当成来源原文。 - 重新计算合计时保留公式与来源，算不清就停止并说明缺什么。 - “推荐”“可调整”“以实际为准”不能代替明确的服务范围。 ## 预览与发布状态 - preview：允许关键缺失项显示“待确认”，页面顶部必须标注“内部预览”。 - blocked：存在资料冲突，停止生成客户页面，只输出冲突清单。 - publish-ready：关键字段已确认，页面无关键占位、无内部制作状态，才可进入发布步骤。 ## 输出要求 - 一个完整 HTML 文件，优先原生 HTML、内联 CSS、少量原生 JavaScript。 - 核心内容不依赖 JavaScript 才显示。 - 手机和电脑均可读，页面整体不得横向滚动。 - 宽表格只能在自身容器横向滚动。 - 图片保持比例并有准确 alt；没有真实链接不做假按钮。 - 提供 @media print，避免标题、表格、图片和费用模块中途断页。 ## 发布前检查 日期、人数、价格、酒店、交通、费用包含/不含、退改政策、真实咨询方式全部确认； 页面中没有关键“待确认”、内部备注、本地绝对路径或敏感信息； 桌面、手机、打印和链接检查通过后，才能标记 publish-ready。
references/itinerary-fields.md 写什么
# 行程字段 ## 基础 目的地、出发地、起止日期、天数、人数、成人儿童构成、出行方式。 ## 每日 日期、起止地点、交通、活动、餐食、住宿、车程或时长、正式提醒。 ## 费用 币种、总价、计价单位、适用人数、儿童政策、单房差、有效期、包含、不含。 ## 条款 退改、成团、天气替换、健康年龄、证件、保险、图片使用和不可抗力。
references/fact-check-gates.md 写什么
# 事实闸门 1. 同一字段多个值：blocked，列出来源，等待确认。 2. 关键字段缺失但不冲突：允许 preview，占位必须醒目。 3. 总价与分项不一致：blocked，不自行改价或凑数。 4. 天数与 D1-Dn 数量不一致：blocked。 5. 酒店晚数与行程天数不一致：blocked。 6. 参考 HTML 与新资料冲突：新资料也不能被自动视为正确，先确认版本。 7. 进入 publish-ready 前：关键占位为 0，内部状态词为 0。
模板负责什么
templates/responsive-itinerary.html 只固定信息骨架、响应式和打印规则，不应该写死目的地、价格、酒店和联系方式。模板里的示例内容必须清楚标记并在生成时全部替换。
<main> <header id="overview">...基础信息...</header> <section id="route">...线路速览...</section> <section id="daily">...每日行程...</section> <section id="hotels">...住宿...</section> <section id="pricing">...报价与费用范围...</section> <section id="terms">...退改与风险提示...</section> <section id="next-step">...下一步确认...</section> </main>
先做最小可用版，再用五类资料把它测坏
创建 Skill 的提示词
请创建一个名为“旅游定制行程网页生成”的 Skill。 使用场景：我会提供旅游行程、报价单、客户需求、参考 HTML 或图片，Skill 要生成完整响应式 HTML。 优先级：准确 > 快速 > 美观。 核心要求： 1. 先完整读取资料，建立来源、事实、结构和冲突清单。 2. 资料冲突时停止并列出冲突，不替我猜。 3. 资料仅缺失时允许生成带“待确认”的内部预览。 4. 日期、人数、价格、酒店、交通、费用范围和退改未确认时，不得标记为可发布。 5. 输出包含封面、速览、每日行程、住宿、费用、包含/不含、退改、风险和下一步。 6. 电脑、手机和打印均可读，不依赖外部 CDN。 请先给我目录结构和 SKILL.md，再说明每个参考文件与模板的用途。
打包前检查
- 压缩包内保留一个独立 Skill 顶层目录，入口文件名准确为
SKILL.md。 - SKILL.md 中引用的 references 和 templates 都真实存在，路径大小写一致。
- 没有 API Key、密码、客户名单、证件或真实订单隐私。
- 模板不写死旧行程事实和旧联系方式。
- 先在测试文件夹导入，确认 WorkBuddy 能识别并触发。
五类验收场景
| 测试 | 输入 | 正确结果 |
|---|---|---|
| 完整资料 | 行程 + 报价 + 规则 | 生成完整预览；复核通过后可标记 publish-ready |
| 缺少价格 | 只有每日行程 | 生成内部预览，价格醒目标为待确认，禁止发布 |
| 日期冲突 | 标题与每日日期不一致 | blocked，列出不同日期及来源，不生成客户版 |
| 只有文字行程 | D1–D5 简表 | 不补编酒店、价格和包含项；以结构清楚的预览呈现 |
| 行程加参考 HTML | 新行程 + 旧样式 | 复用视觉，不复制旧目的地、价格和联系方式 |
小兴安岭案例怎么跑
把长资料拆成事实，不先写标题
识别 D1–D6、5 晚住宿、交通、餐食、门票、服务、价格与退改；每个值保留来源。
先处理冲突
同一酒店评分出现不同数字时，不选更高或更新的那个；先从页面移除，并请产品负责人确认。
再排客户阅读顺序
封面先说 6 天 5 晚和线路，随后是每日行程、住宿、报价、包含不含与正式提醒。
最后做视觉
颜色和图片服务于分组；每个卖点都能在事实账本中找到来源。
本章行动：完成一次红绿测试
先拿一份故意缺价格的行程运行 Skill，确认它不会编价；再补上明确报价重新运行，确认页面从 preview 变为可进入发布检查。只有先证明它会“拒绝乱写”，才值得测它有多漂亮。
用 WorkBuddy 修改与发布
这一章把文件从电脑里的 HTML，带到可核对、可修改、可分享的在线页面。发布不是最后一个按钮，而是最后一道责任门。
第 0 步：先留一份能退回去的版本
在让 AI 大改之前，复制当前可用 HTML，文件名写明日期或版本，例如 小兴安岭行程-20260904-v1.html。不要只相信“撤销”，更不要覆盖唯一原件。
第 1 步：同时提供参考样式与新资料
新建任务后，引用参考 HTML 和需要制作的行程/报价。参考 HTML 只告诉 AI“长什么样”，新资料告诉 AI“这次写什么”。
请调用“旅游定制行程网页生成” Skill 处理我上传的资料。 参考 HTML 只用于学习布局、颜色和模块顺序；不得复制其中的目的地、日期、价格、酒店、联系方式或服务承诺。 请先输出： 1. 来源清单 2. 关键事实账本 3. 缺失项与冲突项 4. 预览版 / blocked / publish-ready 状态判断 如果存在冲突，先停下来让我确认；如果只是缺失，可以生成内部预览。 确认可以生成后，再创建完整单文件 HTML，并检查电脑、手机和打印样式。
第 2 步：看它怎样读资料、写文件、打开预览
不要只看右边页面是否漂亮。左侧执行记录应该能说明它读取了哪些文件、做了哪些检查、写出了哪个新文件。右侧预览用于发现结构和视觉问题，不是事实已经正确的证明。
先改事实，再改样子
第一轮修改不要说“再高级一点”。先按事实账本从上到下检查：标题、日期、人数、每日顺序、住宿晚数、报价、包含与不含、退改。每改一项，都说清“哪里、现在是什么、应该改成什么、其他内容不要动”。
请修改当前 HTML： - 位置：费用不含 - 现状：遗漏“大交通费用” - 正确内容：全国各地往返集合地的大交通费用不含 - 保持不变：行程、酒店、已确认价格、配色和其他模块 修改后请列出改动文件、改动位置和新旧内容；不要顺手重写其他段落。
两条修改路径
适合跨模块修改
更正价格、调整行程顺序、统一酒店名称、修复手机布局。要求 AI 说明改了什么。
适合局部文字和样式
把 HTML 存入资料库后打开，选中需要调整的区域，再用自然语言提出局部要求。HTML 修改会直接生效，改前先留版本。
视觉修改也要具体
请只调整页面视觉，不改任何事实文字： 1. 手机端把双列模块改为单列； 2. 正文最小字号保持 16px，行高不低于 1.7； 3. 宽表格只在表格容器内横向滚动； 4. 图片保持比例，不裁掉文字； 5. 打印时隐藏导航和复制按钮。 完成后分别检查桌面端、390px 手机端和打印版，并报告发现的问题。
修改后必须重跑的检查
- 改价格后，封面、报价表、总价说明和人均计算是否一致。
- 改日期后，星期、D1–Dn、酒店入住和交通安排是否同步。
- 删项目后，亮点、包含项和每日行程是否仍残留旧说法。
- 换酒店后，晚数、房型、早餐和替代规则是否对应。
- 改样式后，手机端、打印版和长链接是否破版。
“能打开”不等于“可以公开”
本地预览通过，只能证明你的电脑能打开。准备发给客户前，还要完成公开内容检查。WorkBuddy 的轻量发布会把 HTML 变成在线链接；开启“发布为网站”后，任何获得链接的人都可能访问。
三种状态先分清
| 状态 | 作用 | 谁能访问 | 适合什么时候 |
|---|---|---|---|
| 本地预览 | 自己检查 HTML | 通常只有本机 | 制作和修改过程中 |
| 邀请协作 | 让指定协作者共同编辑 | 受协作权限控制的人 | 内部审阅与修改 |
| 发布为网站 | 生成只读在线页面 | 任何获得公开链接的人 | 完成最终核对后对外分享 |
发布操作
在资料库打开已确认的 HTML
再次核对文件名和版本，确认不是预览版或旧报价。
点击右上角分享
进入“发布”页签，而不是“邀请协作”。
打开“发布为网站”
系统生成 workbuddy.link 在线地址。开启后，获得链接的人可访问。
复制链接并用无痕窗口复查
检查外部访问、手机排版、图片、目录、价格和链接，不用自己的登录状态替客户判断。
发布前总闸门
- 日期、人数、价格、酒店、交通、费用包含/不含和退改政策已确认。
- 关键“待确认”为 0；页面不再显示“内部预览”。
- 没有客户姓名、手机号、证件、健康信息或不应公开的合同内容。
- 没有本地绝对路径、localhost、失效图片或假按钮。
- 用手机和无痕窗口打开公开链接，逐段核对。
- 记录发布版本和链接；不再需要公开时，关闭“发布为网站”。
常见卡点，不要靠反复重生成解决
| 现象 | 先判断什么 | 处理动作 |
|---|---|---|
| 把本地地址发出去，对方打不开 | 地址是否以 file 或 localhost 开头 | 完成发布检查后，用“发布为网站”生成在线链接 |
| 修改后页面没变化 | 是否打开了旧版本或浏览器缓存 | 核对文件名、更新时间，刷新并重新打开正确文件 |
| AI 改了一个字段，其他内容也变了 | 指令是否说明保持不变的范围 | 退回备份，用“位置 + 正确值 + 保持不变”重做 |
| 手机端右侧被截 | 固定宽度、宽表格、长链接或图片 | 改单列；表格局部滚动；长链接换行；图片 max-width:100% |
| 公开页图片丢失 | 图片是否引用本地路径 | 使用可随页面访问的资源，单文件可嵌入图片 |
| 公开后发现错误或隐私 | 不要先纠结修法 | 立即关闭发布，再修复、复查和重新决定是否公开 |
最后一轮检查提示词
请只审查当前 HTML，不要直接修改。 按以下顺序报告： 1. 日期、人数、价格、酒店、交通、费用范围、退改是否与来源一致； 2. 是否存在资料冲突、关键“待确认”或“内部预览”； 3. 是否含客户隐私、本地绝对路径、localhost、失效图片、假按钮； 4. 桌面端、390px 手机端、打印版是否有溢出、遮挡或裁切； 5. 给出结论：blocked / preview / publish-ready，并列出证据。 只有全部检查通过，才能给出 publish-ready。
本章行动：完成一次不发布的全流程演练
在 WorkBuddy 中上传测试行程和参考 HTML，生成内部预览，故意留一个价格待确认；完成修改和手机检查，但不要打开发布开关。确认发布闸门能拦住你以后，再补齐价格跑第二次。
基础的重要性
智能体的能力会随着时间不断强化，而多数使用者的学习速度很难追上智能体的进化速度。如果每次都从新模型、新按钮重新学起，人永远在追工具。
地基：Skill、工作流、知识库
是我们计调、导游、司机、美工等等的经验积累。
是行程编排。通过合理并且完美的行程编排，满足客户的心理预期。
是目的地吃、住、行、游、购、娱基本元素的汇总。
这就像每年给新入职大学生做培训
把 Skill、工作流和知识库交给 AI，就像给每年新入职的大学生做入职培训。一个人再聪明，没有公司的资料、做事顺序和岗位经验，也很难立刻完成真实工作。
通过文字，把三种基础固定下来
把知识库写下来
按目的地和主题整理吃、住、行、游、购、娱等资料，让内容可以重复读取和持续更新。
把工作流写下来
把行程从需求收集到编排、核对和交付的先后顺序写清楚，让每次执行都有同一条路线。
把 Skill 写下来
把各岗位的经验写成规则、检查项和模板，让 AI 知道什么时候使用、怎样做、什么情况下必须停。
从原始资料到公开链接
资料阶段
- 确定最新行程、报价、客户需求和业务规则。
- 参考 HTML 只作视觉参考，不能带入旧事实。
- 敏感客户信息先脱敏再交给测试流程。
生成阶段
- 建立来源、事实、结构和冲突清单。
- 有冲突即停止；只有缺失才允许带占位预览。
- 完整保留每日行程、住宿、报价、包含不含和正式条款。
修改阶段
- 先留备份，再改事实，最后改视觉。
- 每次修改说清位置、正确值和保持不变的范围。
- 重大改动后重跑价格、日期、住宿晚数与移动端检查。
发布阶段
- 关键占位、内部状态、客户隐私和本地路径全部清零。
- 用无痕窗口和手机打开公开链接复查。
- 记录链接与版本；不用时关闭公开访问。
你真正需要记住的 12 个词
| 词 | 说人话 |
|---|---|
| Skill | 给 AI 的可复用工作说明书与资源包 |
| Prompt | 这一次对 AI 说的任务要求 |
| SKILL.md | Skill 的入口文件，包含触发说明和执行规则 |
| references | 给 AI 读取的业务参考资料 |
| templates | 生成结果时复用的结构或样板 |
| scripts | 适合确定性执行的程序 |
| Markdown | 用少量标记把纯文本结构写清楚 |
| HTML | 定义网页内容与结构 |
| CSS | 控制网页视觉与响应式布局 |
| JavaScript | 为网页增加复制、菜单等动作 |
| 响应式 | 页面根据电脑、手机和打印场景重新排布 |
| 发布为网站 | 把本地 HTML 变成获得链接的人可访问的在线页面 |
资料从哪里来
- 知识库内容：技能——技能安装、查找、创建、启停与安全说明。
- 知识库内容：Skill——技能目录、frontmatter 与资源结构。
- 知识库内容：多人多 Agent 协作——HTML 直接编辑、AI 划词修改及 MD/CSV/HTML 分工。
- 知识库内容：轻量发布——发布为网站、公开链接与关闭访问。
- 用户公开资料：定制游行程网页版快速制作教程——WorkBuddy 上传、生成、资料库修改和发布操作案例。
- 用户提供的 Skills 核心课件、Claude Skills 小白教程、小兴安岭行程资料、旅游行程卡片提示词与现有 HTML——用于概念、案例和结构交叉核对。
- 用户提供的限制传播 PDF 仅用于观察版式与教学节奏；本教程未复制其正文、品牌、水印和会员专属图片。
你不只是会让 AI 写网页了
你已经能把自己的业务判断写成 Skill，把内容放进 Markdown，把结果交给 HTML，再用 WorkBuddy 完成修改与发布。真正的分水岭不是页面有多炫，而是每个数字、每项服务和每次公开都经得起核对。
Skill
Markdown / HTML
准确 ＞ 快速 ＞ 美观
可核对的定制行程
资料核验日期：2026-09-04 · 界面与功能以后续实际版本为准