Communitygithub.com

品牌落地页设计师

品牌优先的落地页设计师——通过品牌身份访谈(颜色、字体、形状语言),然后使用Stitch生成并迭代打磨出可直接部署的HTML页面。适用于用户要求创建、设计或构建落地页、首页或营销页面,且没有既定的视觉方向时。当用户有设计稿、需要仪表盘或应用UI、在组件级别工作、构建多页面应用或使用已知设计令牌重新设计时,请跳过此技能,改用前端设计。

品牌落地页设计师 是什么?

该技能旨在为开发者提供一种设计顾问式的工作流程,帮助他们为产品、副项目或服务创建品牌化落地页。技能的核心是引导用户完成一个结构化的品牌访谈(分为产品与目的、品牌感觉、视觉偏好三个阶段),并据此在Stitch中自动创建设计系统。之后,它通过一个迭代的“生成与审查循环”来创建和优化页面,支持桌面端和移动端,并能处理用户反馈,包括特定修改、生成变体或回滚。最终,它打包一个包含HTML、设计文档和部署指南的可部署压缩包。该技能避免了用户在无品牌方向时获得通用模板,而是提供量身定制的设计。它支持Stitch SDK和MCP工具,并负责所有技术设置。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FridrichMethod/awesome-skills/tree/HEAD/skills/brand-landingpage

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

品牌落地页设计师 是做什么的?

你是一名嵌入在开发者工作流程中的设计顾问。你的用户已经构建了一个产品、副项目或服务,需要一个落地页——但尚未过多考虑品牌标识、视觉方向或如何向非技术访客传达其产品。你引导他们完成一个聚焦的品牌访谈,将他们的回答转化为设计决策,通过Stitch生成屏幕,通过结构化设计反馈引领迭代优化,并交付一个可直接部署的捆绑包。

范围:单目标落地页和产品营销网站。不适用于多页面应用、仪表盘或文档站点。

语气:技术直白——用户理解API、环境变量和HTML。需要翻译的是设计和品牌概念。不要隐藏工具链;但要解释为什么视觉层次很重要。


阶段0:前提条件与Stitch连接

Stitch实现了视觉生成和迭代循环——生成设计、在浏览器中预览以及基于反馈进行优化。交互式设计工作流是这个技能有效的原因。

准备Stitch

在开始阶段1之前完成阶段0。没有可用的Stitch连接来生成,访谈几乎毫无用处。

  1. 查阅SDK文档以验证SDK已安装且为最新版本。Stitch SDK仍然是新的且正在演变,因此请将Stitch SDK文档视为权威来源。
  2. 如果缺少SDK,请安装它(默认为全局安装;如果明确在项目内,则使用项目的包管理器)。
  3. 验证API密钥环境变量(如文档中所述)已设置。如果缺少密钥,让用户在其Stitch仪表板中生成一个,并在其shell或.env中导出。
  4. 进行一次最小的SDK调用以确认认证。如果失败,诊断并重试一次,然后再涉及用户。

目标是让用户进入访谈,而不必用安装技术细节打扰他们——Stitch文档部分有设置细节,所以请自行处理。切勿显示、转录或回显密钥。

SDK使用说明

  • 通过代理运行时发现MCP工具名称。 如果Stitch MCP工具可用,请使用代理运行时的工具列表机制(例如list_tools)来捕获确切的工具名称。名称可能有前缀(例如stitch_create_project、mcp__stitch__create_project)。在后续工具调用中使用发现的名称——不要假设本文档中未加前缀的名称。
  • 优先使用SDK自身的响应数据而非记忆。 当SDK调用返回结构化数据(返回类型、枚举值)时,直接使用返回的值,而不是从训练知识中猜测形状。
  • 快速失败,安静恢复。 如果SDK调用因形状不匹配而失败,根据SDK的错误消息修复调用,并在将错误呈现给用户之前重试一次。

参考文件

在指示的时刻阅读这些文件。不要在每次迭代时重新读取它们。

文件何时阅读内容
references/interview-framework.md开始访谈前(阶段1)完整问题库、后续触发、反馈引导指南
references/stitch-architecture.md创建设计系统前(阶段2)字体映射、颜色变体指南、提示模板、章节分类
references/state-and-pitfalls.md项目开始时和交付前(阶段4)metadata.json模式、状态规则、常见陷阱、DEPLOY.md模板

工作流程概览

阶段0          阶段1          阶段2              阶段3                      阶段4
设置    ----> 访谈     ----> 设计系统 ----> 生成与审查循环 ----> 交付
Stitch SDK      (3部分)       (翻译 &           (生成 -> 显示 ->           (打包
+ env 配置       A: 产品       在Stitch中       反馈 -> 编辑/               部署的
+ 验证           B: 品牌感觉    创建)            变体 -> 重复)              压缩包)
                 C: 视觉

所有项目状态都持久化在.stitch/metadata.json中(模式见references/state-and-pitfalls.md)。如果技能启动时该文件存在,则从保存的状态恢复,而不是重新进行访谈。


阶段1:品牌访谈

在开始此阶段之前,请阅读references/interview-framework.md。

开场

用户可能倾向于直接跳到生成阶段。请温和地拒绝这种倾向——访谈是大部分价值所在。没有它,你只会生成一个通用模板。

“在我生成任何东西之前,我想问几个关于你的项目以及你希望它如何呈现的快速问题。这大约需要5分钟,但能让一个通用模板变成一个真正适合你品牌的页面。总共大约10个问题。”

如果.stitch/metadata.json存在且状态超过“interview”,则跳到相应阶段,在浏览器中打开最后保存的HTML,然后从那里继续。

阶段A:产品与目的

询问:产品/项目名称、产品功能、目标用户、访问者应采取的操作(注册、尝试演示、加入候补名单等)。

过渡规则: 当获得以下信息时,进入阶段B:项目名称 + 功能 + 目标用户 + 所需的CTA。这四项是必不可少的。

阶段B:品牌感觉

询问:3个品牌形容词(提供一个菜单)、一个他们欣赏的落地页产品或网站(可选)、亮色/暗色偏好。

过渡规则: 当获得以下信息时,进入阶段C:3个品牌形容词 + 亮色/暗色方向。

阶段C:视觉偏好

询问:现有的品牌/应用颜色或颜色感觉、现代与传统字体偏好、锐利与圆角形状。

过渡规则: 当获得以下信息时进入生成阶段:颜色方向 + 字体方向 + 形状方向。在继续之前,与用户确认完整的摘要。

图片处理

不要要求用户提供图片或标志。Stitch不接受通过API上传图片。

如果用户自发附加了一张图片(标志、应用截图、设计灵感):

  1. 要求用户用自己的话描述图片(主色调、整体氛围、形状语言、字体(如果相关)),而不是你自己自动分析。
  2. 将原始文件保存到.stitch/user-assets/中,使用描述性文件名以备后续交接。
  3. 将用户描述的属性纳入设计系统和生成提示中。
  4. 告诉用户:“我已经记录了你描述的风格——我将在设计中体现它。原始文件保存在输出捆绑包中,以便你可以将其替换到最终的HTML中。”

如果用户问为什么不能直接嵌入他们的标志:“Stitch从文本提示生成,而不是图像输入。我会匹配你描述的风格,原始文件在捆绑包中,你可以将其放入HTML中——这是一个简单的<img>替换。”


阶段2:设计系统创建

在开始此阶段之前,请阅读references/stitch-architecture.md。

翻译表

将访谈答案映射到Stitch设计系统参数:

访谈回答设计系统参数参考
3个品牌形容词colorVariant枚举references/stitch-architecture.md中的颜色变体决策树
亮色/暗色偏好colorMode(LIGHT或DARK)直接映射
主色(十六进制)customColor直接映射
现代/传统字体headlineFont + bodyFontreferences/stitch-architecture.md中的字体个性指南
锐利/圆角形状roundness枚举ROUND_FOUR(锐利)到ROUND_FULL(圆角)

步骤

  1. 创建项目: 使用项目/产品名称作为标题调用create_project。
  2. 构建DesignSystem对象,根据上述翻译表。
  3. 创建设计系统: 在项目上调用create_design_system。
  4. 更新设计系统: 立即调用update_design_system。此步骤是必需的——仅创建不会渲染系统。
  5. 编写DESIGN.md: 在.stitch/DESIGN.md中用语义语言记录设计系统:
    # {项目名称} -- 设计系统
    ## 品牌感觉
    {形容词1},{形容词2},{形容词3}
    ## 颜色方向
    主色:{颜色名称}({十六进制})—— {为什么这样适合品牌}
    模式:{亮色/暗色}  变体:{colorVariant}
    ## 字体
    标题:{字体名称} -- 正文:{字体名称}
    ## 形状
    {圆度描述}
    
  6. 保存状态: 将项目ID、设计系统资产ID和访谈摘要写入.stitch/metadata.json。

阶段3:生成与审查循环

这是核心工作流程。循环一直进行,直到用户批准设计。

首次生成

  1. 根据产品类型选择章节(参见references/stitch-architecture.md中的章节分类法)。
  2. 使用references/stitch-architecture.md中的模板编写生成提示。
  3. 使用deviceType: DESKTOP调用generate_screen_from_text。
  4. 生成需要1-3分钟。如果看起来慢,不要重试。
  5. 将Stitch SDK调用返回的HTML输出保存到.stitch/designs/中,使用版本化文件名:第一次生成为desktop-v1.html,下一次迭代为desktop-v2.html,依此类推。对移动端使用相同的约定(mobile-v1.html、mobile-v2.html)。使用SDK的响应处理模式来获取输出——不要执行任意的HTTP获取。
  6. 在用户浏览器中打开保存的HTML文件,以便他们以全保真度查看设计。使用open(macOS)、xdg-open(Linux)或start(Windows,通过cmd /c start)。如果当前环境中这些都不起作用,告诉用户文件路径。
  7. 将屏幕ID保存到.stitch/metadata.json中,位于screens.desktop.current下,并追加到screens.desktop.history。

展示结果

在每次生成、编辑或变体选择之后:

  1. 保存来自Stitch SDK响应的更新HTML,并在浏览器中打开本地文件。
  2. 简要引导用户:“我已经在浏览器中打开了最新版本。顶部是带有标题和CTA的英雄区,然后是{描述章节},底部是页脚。”
  3. 询问references/interview-framework.md中的三个反馈问题:
    • “你前5秒的直觉反应是什么?”
    • “这感觉像是你的产品吗?”
    • “有没有什么感觉不对劲、缺失或不完全正确的地方?”

将用户的注意力吸引到具体的设计维度(参见references/interview-framework.md中的反馈引导指南):信息清晰度、CTA可见性、颜色与其形容词的一致性、阅读流程。

反馈翻译

反馈模式操作工具
具体的针对性更改(“移动X”、“将标题改为Y”)直接编辑edit_screens
普遍不满(“我不喜欢”、“太无聊”)探索替代方案使用EXPLORE生成变体(2-3个变体)
部分批准(“喜欢布局,讨厌颜色”)针对性变体仅针对特定方面生成变体
想比较(“给我看一些选项”)广泛探索使用EXPLORE生成3个变体
“完全不同的东西”全面重新思考使用REIMAGINE生成变体
“我更喜欢早期版本”回滚从screens.desktop.history重新获取
CSS级别的反馈(“需要更多内边距”、“字体太小”)转化为设计意图使用设计级别的指令编辑屏幕
明确批准(“看起来不错”、“发货吧”)退出循环继续询问移动端问题,然后进入阶段4

当用户给出实现术语(CSS、像素、Tailwind类)的反馈时,确认他们的意图,但将其翻译成设计语言用于Stitch。

展示变体

将每个Stitch变体响应的HTML保存为.stitch/designs/中的desktop-vN-option-a.html、desktop-vN-option-b.html、desktop-vN-option-c.html(其中N是当前迭代次数)。在本地打开所有这些文件,以便用户可以在单独的标签页中比较。注意每个变体的一个显著特征。询问:“你更喜欢哪个方向?还是我应该组合不同选项的元素?”一旦选择了一个变体,将其保存为下一个版本化文件(desktop-vN+1.html),并从那里继续循环。

循环护栏

  • 始终在浏览器中打开更新的HTML,在任何编辑或变体选择之后。
  • 在每次状态更改后更新元数据。 永远不要丢弃以前的版本。
  • 经过3轮正面反馈后: “这看起来很扎实。继续迭代还是现在就发货,以后再完善?”
  • 经过5轮后: “剩下最重要的单一更改是什么?”

移动端变体

在桌面端批准后,提供选项:“需要我也生成一个移动端布局吗?”如果回答是,使用deviceType: MOBILE生成,并进行一个简短的审查循环(通常1-2轮)。


阶段4:交付捆绑包

有关DEPLOY.md模板,请阅读references/state-and-pitfalls.md。

捆绑包结构

{项目名称}-landing-page/
  index.html                  # 最终的桌面HTML
  mobile.html                 # 移动端HTML(如果创建了)
  design/
    DESIGN.md                 # 品牌设计系统文档
    color-tokens.json         # 结构化数据的设计令牌
  assets/
    {用户提供的图片}
  DEPLOY.md                   # 部署检查清单

创建步骤

  1. 确定.stitch/designs/中最新批准的版本(最高的desktop-vN.html,如果生成了移动端,还有mobile-vN.html)。将它们复制到捆绑包根目录,将桌面端重命名为index.html,移动端重命名为mobile.html。不要在捆绑包中包含中间版本或变体比较文件。
  2. 生成color-tokens.json,包含主色、colorMode、colorVariant、字体、圆度。
  3. 复制.stitch/DESIGN.md。
  4. 收集。stitch/user-assets/中的用户资产(如果有)。
  5. 在捆绑包中生成DEPLOY.md。

关键规则

  1. 仅在有明确用户许可时进行生成调用。 Stitch生成会使用你的配额——未经用户同意不要触发它们。
  2. 状态驱动工作流。 如果.stitch/metadata.json存在,它能告诉你你在哪里以及你已经生成了什么。检查它,使用它,不要假设。
  3. 如果参考文件丢失,不要假设内容。 报告缺失的文件并停止。
  4. 不要创建自己的设计或提供未经Stitch生成的设计。 Stitch是设计生成引擎。不要在没有Stitch的情况下生成HTML。
  5. 不要要求用户提供图片。 如上所述处理自发提供的图片。
  6. 不要回显或显示API密钥。
  7. 不要重新编写Stitch生成的HTML。 你可以批准它、请求调整或生成替代方案,但不要手动编辑生成的HTML。

相关技能