个性化站点
目标
将已生成的静态站点个性化,使其感觉像是用户自己的网站,而不是模板、演示或复制的参考站点。
本技能负责编辑内容和元数据。它不负责选择主题、重新设计布局、重建参考网站、迁移大型文章存档、发布站点或将项目转换为其他框架。
契约
输入:
- 已生成的静态站点文件夹、
EDITING.md、页面地图或交接笔记。 - 用户提供的身份/内容:个人简介、简历、GitHub README、旧主页、社交链接、项目、头像/logo、联系方式或具体的替换内容。
- 需要替换的现有数据文件、JavaScript数据块、元数据和占位内容/源站点内容。
输出:
- 个性化的可见内容、元数据、链接、图像和源代码级别的身份字段。
- 移除或替换模板/演示/源站点的残留内容。
- 更新后的
EDITING.md,描述了已填充的字段、剩余的占位内容和内容位置。
边界:
- 不要选择新主题、重新设计布局、重建新的参考站点、导入大型文章存档、发布或转换框架。
- 不要虚构具体的个人信息、雇主、学校、奖项、日期、地点或指标。
- 不要不必要地将用户私人数据粘贴回最终报告中。
成功标准:
- 用户提供的身份/内容出现在正确的浏览器可见位置。
- 重要的占位内容和源站点身份已被移除或有意识地记录。
- 更改后的内部链接/资源保持页面相对路径且有效。
review-static-site能够通过或仅报告可接受的限制。
如果标准未达到:
- 重新清点HTML、元数据、数据文件和JavaScript渲染的内容。
- 替换遗漏的占位符/源站点字符串。
- 对于因新内容导致的较小布局问题,使用
edit-site-part。 - 修复后再次使用
review-static-site。
1. 输入
使用任何可用的材料:
- 静态站点文件夹,通常为
site/、dist/、out/或public/。 - 来自其他技能的
EDITING.md、页面地图或交接笔记。 - 用户提供的个人简介、简历、CV、GitHub README、旧主页、社交链接、项目列表、头像、logo或联系方式。
- 现有的数据文件,如
profile.json、posts.json、projects.json或assets/script.js中的数据块。 - 用户提供的具体替换说明。
如果缺失重要信息,请使用清晰的占位符,而不是虚构详细的个人信息。
2. 内容清点
在编辑之前,确定个人或占位内容的位置。
检查:
- HTML文件及其子页面。
<title>、meta描述、Open Graph/Twitter元数据、favicon/logo引用和可见标题。- 页眉、导航、英雄区、个人简介/关于部分、联系区块、页脚、侧边栏、卡片和浮层。
- JSON文件、JavaScript数据块或重复的HTML列表中的重复内容。
- 文章/详情演示页面、项目页面、笔记页面、链接页面以及特殊页面。
EDITING.md中的说明以及任何记录的内容位置。
查找常见的占位文本或演示文本,例如 你的名字、[email protected]、example.com、lorem ipsum、示例文章、示例项目、TODO、替换我 以及类似的字符串。
3. 个人身份替换
一致地替换可见和源代码级别的身份字段。
典型字段:
- 站点标题、作者姓名、显示名称、角色、标语、简短个人简介、位置、可用性/状态和兴趣。
- 电子邮件、社交链接、GitHub、X/Twitter、LinkedIn、Bluesky、RSS、简讯、简历/CV以及其他用户提供的链接。
- 头像、logo、favicon、alt文本、图片说明和个人简介标签。
- 首页英雄区文案、关于页面文案、联系页面文案、页脚文本和元数据描述。
不要虚构具体的雇主、学校、奖项、出版物、指标、地点或年份。如果用户未提供某些内容,请保持中性且易于替换。
在替换链接或资源时,保持静态路径兼容性:
- 保持站点内链接和资源为页面相对路径,而不是根绝对路径。
- 对于根页面,使用类似
assets/avatar.png、about.html和posts/example.html的路径。 - 对于嵌套页面,使用正确的深度,例如
../assets/avatar.png和../index.html。 - 不要为内部链接引入
/assets/...、/posts/...、/images/...、/data/...或/,除非站点有意只通过服务器根路径访问,且用户接受直接打开文件可能失败。 - 外部链接(如GitHub、LinkedIn、电子邮件和个人域名)可以保持为绝对URL。
4. 源站点和模板清理
当对样式复制的站点进行个性化时,默认情况下移除源站点的身份和特定内容。
替换或移除:
- 原作者姓名、用户名、域名、邮箱、社交链接、分析ID、友情链接、私有URL、许可文本、站点统计和社区链接。
- 原文目录、文章正文、项目名称、个人评价和个人陈述。
- 从源站点下载的头像、封面、截图、logo或其他资源,除非用户拥有其所有权或已获得许可。
保留视觉结构和交互模式,但使内容明确属于用户或保持中性的占位内容。
5. 内容适配
根据站点现有的样式和布局来适配用户的材料,而不是到处粘贴冗长的原始文本。
根据站点的概念来塑造文案:
- 极简站点:简洁、平静、直接。
- 终端/存档风格:个人简介、日志、状态、目录或类配置的措辞。
- Bento风格:简短的模块化片段。
- 研究主页:正式、精确、面向项目/出版物。
- 博客或数字花园:写作主题、近期笔记、标签和阅读路径。
- 作品集:精选作品、角色、成果、技术栈和链接。
保持文本长度适合现有的容器。如果用户提供的段落对于卡片来说太长,请总结它,并将更完整的版本放在关于页面中。
当存在集中式数据源时,优先编辑它们。如果内容跨文件重复,请一致地更新所有可见和元数据副本。
6. 验证
使用实际可用的交互式浏览器工具作为首选方式来检查本地预览,并确认个性化内容确实出现在正确的位置。“可用”意味着它在当前轮次的可调用工具列表中公开。在Codex中,这可能是被路由到该轮次的浏览器/应用内浏览器插件;在其他代理中,这可能是一个等效的可见浏览器、浏览器使用工具或基于开发者工具(devtools)的浏览器。
如果没有可调用的交互式浏览器工具,不要假装已经进行了浏览器放置检查。如果视觉放置很重要,请要求用户启用或调用浏览器工具;对于Codex,这可能意味着发送一个明确提及 @browser 的请求。如果用户未重新路由或客户端没有此类工具,则回退到Playwright、截图、静态审查或源代码检查,并说明限制。
当交互式浏览器工具实际可调用时,不要默认使用Playwright或仅截图的验证方式。仅在无法调用交互式浏览器工具、用户明确要求或需要可重复的脚本化回归测试时,才将Playwright作为回退方案。
检查应显示用户信息的页面,例如首页、关于/个人简介页面、联系页面、项目页面、链接页面以及代表性的文章/详情页面。确认用户提供的姓名、标语、个人简介、头像/logo、联系方式、社交链接、项目名称和精选项目出现在预期位置。
同时确认重要的占位内容或源站点身份在浏览器中不再可见。这是一个内容放置检查,而不是完整的视觉重新设计步骤。
如果个性化更改了头像、favicon、社交图标、项目链接、文章链接或数据驱动的卡片,请确认更改后的路径从受影响的页面深度正常工作,并且没有意外引入根绝对路径的站点内部链接。
最后,调用或建议使用 review-static-site。
编辑指南
当 EDITING.md 存在时更新它,如果站点旨在可复用,则创建它。
记录:
- 哪些个人字段已被填充。
- 哪些内容仍为占位符。
- 个人简介、链接、项目、精选项目、文章、图片和主题文本现在位于何处。
- 任何复制到站点中的用户提供的资源及其引用位置。
- 任何有意移除或替换的源站点内容。
保留此指南供未来的代理和用户使用,而不是作为网站内的营销文案。
输出
完成后,简短报告:
- 哪些个人信息和页面已更新。
- 哪些文件发生了更改。
- 哪些占位符或源站点特定的残留内容仍然存在(如果有)。
review-static-site是否已运行或下一步应运行。
不要不必要地将用户的私人个人数据粘贴回去。