查找风格参考
目标
在实现之前,将已选择或粗略描述的个人网站风格转化为具体、经过验证的设计参考。
此技能属于研究和设计简报技能。它不构建网站,也不克隆单个目标网站。它查找多个真实参考,进行检查,提取可复用的设计模式,并生成可供 make-personal-site 直接使用的构建简报。
约定
输入:
- 用户的风格方向、主题词、网站类型、受众、内容范围、参考或约束条件。
- 可选的要包含或避免的示例、偏好的平台/模板来源以及目标网站结构。
输出:
- 4-8 个相关参考候选(如有),包含来源 URL 和简短理由。
- 在工具可用时,对所选参考进行浏览器或截图观察记录。
- 一份实用的参考简报,涵盖布局、导航、首屏、文章列表、文章详情、项目/关于区域、色彩、排版、图像、动效、交互和响应式行为。
- 清晰的“借鉴”和“避免”注释。
- 最终交付给
make-personal-site的构建交接。
边界:
- 不实现网站。
- 不复制受保护的源代码、图片、个人身份信息、分析 ID 或品牌资产。
- 不将单一参考视为克隆目标。如果用户希望复制某个特定网站,请转向
copy-website-style。 - 不在框架安装或构建可行性上花费时间;此技能仅研究设计参考。
成功条件:
- 方向已基于具体参考,并且足够具体,使
make-personal-site能构建一个原创的静态网站。 - 参考研究使用了多个搜索角度,而非单一关键词。
- 尽可能检查了至少 3 个强参考(除非用户明确要求快速草稿)。
- 最终简报将可复用的设计语言与不应复制的內容/身份信息区分开来。
如果条件不满足:
- 使用更广泛或替代关键词进行搜索。
- 检查更少但更强的参考。
- 如果方向本身仍不明确,返回
search-blog-theme。 - 仅在多个参考系列会导致截然不同的网站时,提出一个简洁的偏好问题。
何时使用
在以下情况使用此技能:
- 用户已给出一个宽泛的方向,例如:自然风格技术博客、安静的研究主页、复古终端档案、温馨笔记站点或粗野主义作品集。
search-blog-theme已推荐一个方向,但在构建之前仍需实际示例。from-idea-to-personal-site即将根据品味词汇而非具体参考 URL 构建原创网站。- 代理在
make-personal-site之前需要更多的视觉依据。
在以下情况不要使用此技能:
- 用户尚未选择任何方向;请使用
search-blog-theme。 - 用户提供了一个目标 URL 并希望精确复制;请使用
copy-website-style。 - 网站已存在,仅需微小修改;请使用
edit-site-part。
工作流程
-
在内部将风格方向重述为可搜索的关键词。 输入:用户的品味和网站目的。 输出:5-10 个跨多个角度的搜索短语。 条件:搜索短语涵盖情绪、网站类型、视觉系统、结构以及至少一种替代措辞。
-
搜索真实参考。 输入:搜索短语。 输出:候选网站、模板、作品集、博客、设计页面或 GitHub 演示。 条件:在确定参考之前,至少使用 3 个不同的搜索角度,除非用户明确要求快速草稿。
-
检查所选参考。 输入:顶级候选。 输出:浏览器/截图观察记录。 条件:尽可能检查至少 3 个强参考;当方向较宽泛时,使用 4-6 个。
-
提取设计模式。 输入:已检查的参考。 输出:可复用的模式和反模式。 条件:记录关注的是布局、层级、交互、排版、色彩、内容密度和响应式行为,而非仅仅是氛围。
-
综合一份构建简报。 输入:参考模式加上用户约束。 输出:一份供
make-personal-site使用的简洁设计简报。 条件:简报足够具体,无需另一轮调研即可实现。
搜索指导
通过组合以下内容构建搜索:
- 网站类型:个人网站、个人博客、作品集、研究主页、数字花园、笔记站点、开发者博客。
- 情绪:自然、安静、编辑风、温馨、原始、粗野主义、终端、档案、笔记本、花园、极简、有趣、科学。
- 结构:博客首页、文章索引、项目网格、侧边导航、便当盒、时间线、笔记存档、Now 页面。
- 来源:v0 模板、Figma 社区、GitHub 主题、个人网站、Astro/Hugo/Jekyll/Quartz 示例、设计灵感网站。
偏好具体短语而非模糊短语。例如:
- natural developer personal website
- calm technical blog personal site
- digital garden nature inspired design
- research homepage personal website minimal
- personal blog template notes projects
不要在一个搜索短语或第一个吸引人的结果后就停止。对于一个诸如“赛博朋克技术主页”的方向,应跨多个角度进行搜索,例如:
- cyberpunk developer personal website
- futuristic technical blog personal site
- terminal cyberpunk portfolio website
- neon brutalist personal website
- sci fi interface personal homepage
使用当前的网络搜索来获取参考,因为模板、作品集和设计示例会随时间变化。
浏览器检查
对于每个强参考,使用实际可用的交互式浏览器工具检查实时页面。“可用”意味着它在当前轮次的可调用工具列表中公开。在 Codex 中,当其被路由到当前轮次时,这可能指浏览器/应用内浏览器插件;在其他代理中,它可能是一个等效的可见浏览器、browser-use 工具或 devtools 支持的浏览器。
如果没有可调用的交互式浏览器工具,请不要假装参考已在浏览器中经过视觉检查。如果视觉参考的保真度很重要,请要求用户启用或调用浏览器工具;对于 Codex,这可能意味着发送一个明确提及 @browser 的请求。如果用户没有重新路由,或者客户端没有此类工具,则回退到 Playwright、截图、搜索结果片段、源页面或书面描述,并说明限制。
当交互式浏览器工具实际可调用时,不要默认使用 Playwright、仅截图审查或搜索结果片段。截图可以在交互式浏览器通过后作为证据捕获,但不能替代交互式检查。仅当没有可调用的交互式浏览器工具、用户明确要求使用,或需要可重复的脚本化比较时,才将 Playwright 作为回退方案。
检查:
- 首屏:哪些內容立即可用?
- 导航:顶部导航、侧边导航、命令/菜单、标签、搜索、存档链接。
- 内容模型:博文、笔记、项目、关于、链接、记录、Now、花园、简历。
- 阅读体验:文章宽度、排版、代码块、数学公式、图片、脚注、目录。
- 视觉系统:调色板、间距、圆角半径、密度、卡片、分隔线、纹理、图像。
- 动效与交互:悬停状态、主题切换、筛选、搜索、滚动效果、页面过渡。
- 响应式行为:移动端应发生什么?
- 风险:哪些部分会变得难以阅读、过于通用、过于沉重或与来源过于相似?
如果浏览器工具不可用,请使用源页面、搜索结果片段、截图和书面描述,并说明视觉检查有限制。
输出格式
保持回复自然且有帮助。不要暴露冗长的隐藏处理日志。
包含:
- 简短推荐:最值得构建的方向。
- 参考:4-8 个项目,包含 URL/来源及其重要性理由。
- 借鉴:具体的可改编模式。
- 避免:不应复制或会损害用户网站的內容。
- 构建简报:供
make-personal-site使用的确切方向。 - 交接:推荐的下一个技能及任何来源约束。
当用户要求快速回答时,将输出压缩到最佳 3-5 个参考和一份简报。
构建简报要求
最终简报应明确:
- 站点身份:用一个短语描述网站应给人的感觉。
- 页面范围:首页、博客索引、文章详情、项目、关于、笔记/记录、链接或其他页面。
- 首屏:立即可用的有用內容。
- 布局:导航、内容列、侧边栏、卡片/列表、存档结构。
- 视觉系统:调色板、排版样式、间距、边框、图像、图标风格。
- 交互:主题切换、筛选/搜索、复制按钮、悬停状态、可选动效。
- 响应式行为:移动导航和內容优先级。
- 请勿复制:原始个人身份信息、文章、资产、标识、专有代码、分析或确切的品牌处理方式。
交接
在简报准备好之后:
- 将原创网站构建路由到
make-personal-site。 - 将单一网站的精确复制路由到
copy-website-style。 - 将未解决的方向选择路由回
search-blog-theme。