着陆页
这是着陆页工作的入口。在 landing/brief.md 中确定简报,然后按固定顺序运行此插件的六个技能,以确保页面在文案完成之前不会布局,在设计方向确定之前不会编码。
按此方式开始。如果 landing/brief.md 存在,则读取它,并仅询问缺少的内容。否则,先询问(参见“当信息缺失时”),然后编写它。同时阅读项目(README、package.json、现有站点),不要询问项目中已有答案的内容。在简报编写完成之前,不进行文案、设计或编码。
简报
每行一个字段,使用用户的措辞:
- 类型:SaaS、产品、服务或工作室、候补名单、活动,或混合类型。
- 语言:语言及其国家或地区变体(如
es-CL、en-GB)。对于西班牙语,还需指明称呼形式(tú、usted、vos),因为词汇、数字格式和货币随国家而变化。 - 产品:产品功能,包含用户给出的所有事实:特性、数字、地点、日期。
- 受众:目标用户群体,以及他们当前使用或做的事情。
- 转化动作:单个动作,以及点击后的行为。要么提交一个表单(包含哪些字段,以及端点(如果存在),或
none yet),要么打开一个外部页面(结账、预订、应用商店)到指定 URL。 - 定价:业务提供的价格结构。
- 可用证明:用户评价、指标、客户姓名、标志、媒体报道,完全按提供的内容记录。
- 可用素材:照片、截图、标志、视频、3D 模型,附带路径。
- 品牌约束:颜色、字体、标志规则、语气素材,以及任何要求或禁止的内容。
- 技术栈:用户命名的技术栈。如果未命名,则写
detect;landing-skills:landing-build将从项目文件中检测,拥有该表格的所有权,并将解析后的技术栈写回此字段。 - 域名:生产域名。
landing-skills:landing-build仅在已知时写入规范 URL、og:url、og:image和站点地图。 - 联系方式:电子邮件、电话、地址、即时通讯渠道、工作时间,按提供的内容记录。它们会放在页脚和表单的错误页面上。
- 期望效果:用户要求的动效、3D 或滚动效果,使用用户的措辞。这些不是文案的声明:设计方向决定其角色,
landing-skills:landing-motion负责实现。
当用户表示“没有”时写 none,当无人回答时写 unknown。一个虚构的示例:
# 简报:Keyline Tuning
类型:服务
语言:en-GB
产品:在大曼彻斯特地区客户家中进行钢琴调音;一次调音大约需要 90 分钟
受众:家中有立式钢琴且多年未调音的人
转化动作:通过表单预订上门服务(姓名、邮编、电话、首选周);端点:none yet
定价:unknown
可用证明:none
可用素材:none
品牌约束:unknown
技术栈:detect
域名:unknown
联系方式:电话,号码未知
期望效果:none
工作顺序
- 内容,
landing-skills:landing-copy。文案决定章节、顺序和长度;先绘制的布局会成为文案被迫适应的模板。要求用户批准landing/copy.md或回答其未解决的问题。如果无人看管,继续推进并说明文案未获批准。 - 设计,
landing-skills:landing-art-direction。设计方向决定设计令牌;在此之前编写的代码会硬编码默认颜色和字体。 - 编码,
landing-skills:landing-build。静态页面必须在添加动效之前,在 JavaScript 关闭的情况下也能工作,因为这是脚本失败、WebGL 缺失或访问者请求减少动效时的回退方案。 - 动效,
landing-skills:landing-motion。始终执行此步骤。在动效意图为none时,它只是对反馈状态的简短检查。 - 审查,
landing-skills:landing-review,在宣布工作完成之前。一个看起来完成的页面仍可能流失每个潜在客户或包含无人提供的声明。“完成”意味着landing/review.md以Verdict: pass开头。 - 发布,
landing-skills:landing-launch。它准备并本地测试发布;部署、DNS 和帐户更改仅在用户明确同意的情况下运行,此规则由该技能负责。如果无人看管且无人可问,则在准备后停止并报告准备就绪的内容。
在 fail 之后,将每个发现发送到其区域(copy、art-direction、build、motion 或 launch:landing-skills:landing- 加上区域名称)指定的技能,然后再次审查。修复需经过其后的步骤:添加到文案中的章节需要布局行和标记。在 incomplete 之后,让页面提供服务并再次审查。经过两次失败轮次后,停止并将未解决的发现报告给用户,而不是循环。
交接
| 步骤 | 技能 | 读取 | 写入 |
|---|---|---|---|
| 简报 | landing-skills:landing-page | 对话记录、项目文件 | landing/brief.md |
| 内容 | landing-skills:landing-copy | landing/brief.md | landing/copy.md:每个 H2 对应一个章节,按页面顺序排列,最后一个 H2 为 Placeholders |
| 设计 | landing-skills:landing-art-direction | landing/brief.md、landing/copy.md | landing/direction.md,最后一个 H2 为 Motion and 3D intent;landing/tokens.css |
| 编码 | landing-skills:landing-build | landing/brief.md、landing/copy.md、landing/direction.md、landing/tokens.css | 静态页面;对于表单,还包括 form.js、/thanks/ 和 /form-error/;纯 HTML 放入 public/,并附上 tokens.css 的副本 |
| 动效 | landing-skills:landing-motion | landing/direction.md 中的 Motion and 3D intent、静态页面、landing/tokens.css | 页面上的动效,放在其自己的文件中;tokens.css 保持不变 |
| 审查 | landing-skills:landing-review | 页面、landing/brief.md、landing/copy.md、landing/direction.md、landing/tokens.css | landing/review.md、landing/review-checklist.md、landing/shots/ 中的截图 |
| 发布 | landing-skills:landing-launch | 构建的页面及其表单字段名称;landing/brief.md 中的转化动作、域名和联系方式;landing/copy.md 中的表单消息 | 托管配置;当表单没有端点时,包括表单 Worker 和添加到构建表单的 Turnstile 小部件;分析和转化事件;landing/launch.md 及其检查清单 |
每个技能也可以独立工作,以便用户可以从中间步骤开始。运行请求中指定的技能。它需要这些文件,当某个文件缺失时,它会自己处理缺口(它会询问,或临时工作并说明情况),所以不要为了解除阻塞而编写缺失的文件:
- 文案:
landing/brief.md。 - 设计方向:
landing/brief.md和landing/copy.md。 - 编码:
landing/copy.md、landing/direction.md、landing/tokens.css以及(如果存在)landing/brief.md。 - 动效:静态页面、
landing/direction.md、(如果存在)landing/tokens.css。 - 审查:仅页面。审查现有站点仅使用
landing-skills:landing-review。 - 发布:构建的页面。
当信息缺失时
将请求与字段进行比较,并在一条编号消息中询问每个缺失的字段,分为两组:
- 没有它们就无法开始的内容:产品事实、受众、转化动作及点击后的行为、语言和国家。
- 具有安全默认值的内容,在问题中说明,以便用户可以接受它:技术栈(从项目中检测,或纯 HTML)、期望效果(
none)、域名(在已知之前从页面中排除)以及其余内容。
切勿用虚构的受众、价格、用户评价、指标、客户姓名或日期填补空白。一个看似合理的猜测最终会成为页面上的声明,而看到一个破绽的访问者会怀疑所有其他内容。
当用户无法回答,或无人可问时:
- 关于业务的事实(价格、证明、受众、点击后的行为、联系方式)写为
unknown。landing-skills:landing-copy会将其转换为可见的[PLACEHOLDER: 需要什么]并将其列出。 - 页面未声明的工作性选择可以写为
assumed: <值> (原因):页面类型和用户消息的语言。仅当确定时才记录地区变体;对于西班牙语,国家和称呼形式保持unknown,直到被询问,因为文案依赖它们。
然后继续,并告知用户哪些字段是 unknown 或 assumed。