构建个人网站
目标
将个人网站技能套件协调为可靠的工作流。
这是一个编排技能,而非实现技能。它应路由到正确的专门技能,强制执行质量门控,并推动工作流持续前进,直到当前请求达到其自然停止点。
不要重复子技能中的详细实现规则。在到达其步骤时加载并遵循子技能。
对于面向用户的“从创意到个人网站”或一键启动请求,优先使用 from-idea-to-personal-site。当下一步或子技能选择是主要问题时,使用本技能作为较低级别的路由协调器。
契约
输入:
- 用户请求、网站文件夹或所需输出文件夹、参考资料、身份材料、内容材料以及可选的发布目标。
- 当用户询问下一步时,提供当前工作流状态。
输出:
- 选定的工作流路由和已执行的子技能。
- 根据请求,输出本地静态站点、已验证的现有站点、导入的内容、聚焦的编辑或发布准备。
- 交接摘要,包含网站文件夹、预览/发布状态、已执行的验证以及剩余的 manual 步骤。
边界:
- 当有专门的子技能适用时,不要直接实现子技能的细节。
- 不要默认运行所有子技能;选择满足请求的最短链。
- 除非明确请求,否则不要发布、推送、创建项目、绑定域名或更改 DNS。
- 在生成、重建、个性化、文章导入或广泛编辑之后,不要跳过
review-static-site。
成功门控:
- 选定的子技能链达到用户的自然停止点:方向已选择、网站已构建、内容已添加、网站已验证、编辑已完成或部署已准备/执行。
- 必需的质量门控已通过,或者用户明确接受已记录的局限性。
如果门控失败:
- 将失败的门控路由到最小责任的子技能。
- 重新运行受影响的验证。
- 仅当缺少用户内容、缺少凭据、资源不可用或外部帐户操作阻止进展时,停止并报告障碍。
子技能
将这些技能用作工作流构建块:
search-blog-theme:发现并比较个人网站/博客主题方向。find-style-references:搜索并检查所选方向的真实网站/模板/截图,并生成可构建的参考简报。make-personal-site:创建原始的零依赖静态个人网站。copy-website-style:重建特定参考网站的样式、布局、动效和页面类型。personalize-site:用用户自己的内容替换占位符/演示/源身份。add-blog-posts:将 Markdown、Obsidian 笔记、Word 草稿、旧 HTML 文章、图片、数学内容、链接和其他写作内容导入现有网站。edit-site-part:对特定部分、组件、文本块、样式细节或交互进行聚焦的本地更改。review-static-site:验证静态输出,检查链接、页面类型、浏览器渲染、编码、占位符残留、直接打开兼容性和路径正确性。publish-static-site:准备或执行部署到 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel。
如果子技能名称发生变化,优先使用本地安装的具有相同用途的技能。
子技能契约矩阵
使用此矩阵来决定交接和修复循环:
| 子技能 | 必需输入 | 预期输出 | 成功门控 | 如果门控失败 |
|---|---|---|---|---|
search-blog-theme | 用户品味、目的、参考资料或关键词 | 3-5 个方向、已验证的参考 URL、一个推荐 | 方向足够具体以进行构建 | 搜索更多参考资料、完善隐喻或提出一个偏好问题 |
find-style-references | 所选样式方向、网站类型、情绪词或示例 | 4-8 个真实参考、浏览器观察、可构建设计简报 | 尽可能从多个搜索角度检查至少 3 个强参考 | 扩大搜索范围、检查更强的参考或返回 search-blog-theme |
make-personal-site | 方向、内容/个人资料提示、页面范围、输出文件夹 | 包含代表性页面、资产、EDITING.md 的纯静态网站 | 必需的页面类型、相对路径、UTF-8 源文件、本地预览 | 修复结构/路径/资产,然后 review-static-site |
copy-website-style | 目标 URL/截图/模板和范围 | 包含页面地图、占位符/用户内容、EDITING.md 的静态样式重建 | 标志性布局/动效/页面类型与请求的保真度匹配 | 重新检查目标、迭代重建,然后 review-static-site |
personalize-site | 现有网站加上用户身份/内容 | 已替换的身份、链接、元数据、资产、占位符/源清理 | 用户内容可见且残留已移除 | 重新盘点内容位置或使用 edit-site-part 处理布局适配 |
add-blog-posts | 现有网站加上源文章/资产 | 新文章页面、更新后的索引/数据、复制的资产、编辑笔记 | 文章正确渲染,链接/资产/数学内容/富内容正常工作 | 修复转换/索引/资产或使用 edit-site-part 处理本地展示问题 |
edit-site-part | 现有网站加上目标页面/区域/更改 | 小的、范围限定的代码/内容/样式/交互编辑 | 同一浏览器区域显示所请求的更改且未引起无关破坏 | 重新映射源并进行更小的修正性编辑 |
review-static-site | 静态根目录、预期范围、可选禁止字符串/参考 | 发现或修复、审计/浏览器结果、通过/失败状态 | 不存在阻碍性障碍 | 将障碍路由到最小责任的子技能 |
publish-static-site | 已验证的部署根目录加上所选平台/模式 | 部署设置/配置、可选实时 URL、部署后检查 | 正确的文件夹已部署且实时 URL 正常工作 | 修复本地障碍、部署设置或帐户/DNS 步骤 |
操作原则
- 先路由,后执行。在进行广泛编辑之前决定正确的链。
- 确保每一步的输出可被下一步使用。
- 除非用户明确请求其他技术栈,否则在此版本中优先使用纯 HTML/CSS/JS 和零依赖。
- 不要将个人网站或博客转变为营销着陆页。
- 当缺少用户数据时,不要编造详细的个人事实。
- 在样式重建中默认替换复制的源网站身份。
- 默认使用页面相对链接和资产;避免根绝对路径的网站本地路径,例如
/assets/...或/posts/...。 - 在任何生成、重建、个性化、文章导入或广泛编辑之后,使用
review-static-site进行验证。 - 除非用户明确请求,否则停留在本地已验证的网站。
- 除非用户明确请求,否则不要创建仓库、推送代码、部署、绑定域名或更改 DNS。
接收
仅收集下一步决策所需的信息。不要过度询问用户。
有用输入:
- 所需输出文件夹或现有网站文件夹。
- 用户是否想要新网站、重建参考、导入内容、个性化、本地编辑、验证或发布。
- 参考 URL、截图、模板或主题词。
- 用户身份材料:姓名、简介、链接、简历、项目、头像/标志、旧主页、GitHub 个人资料。
- 内容材料:Markdown、Obsidian 笔记、Word 文档、旧文章、图片文件夹或粘贴的文本。
- 发布目标:GitHub Pages、Cloudflare Pages、Netlify、Vercel 或仅提供指导。
如果请求足够清晰,则继续。仅在多个路由会产生截然不同的工作时才提出一个简洁的问题。
路由
根据用户当前状态选择工作流:
- 模糊的想法或“给我找个样式”:使用
search-blog-theme,然后在原创构建之前使用find-style-references。 - 已选择方向但无特定目标网站:使用
find-style-references,然后使用make-personal-site。 - 指定了要紧密匹配的目标 URL/截图/模板:使用
copy-website-style。 - 现有生成的网站仍包含占位符或复制的身份:使用
personalize-site。 - 现有网站加上新文章/笔记/文档:使用
add-blog-posts。 - 现有网站加上一个小的视觉/文本/布局/交互更改:使用
edit-site-part。 - “检查这个网站”、“这个够好吗”、“发布前”:使用
review-static-site。 - “部署”、“发布”、“GitHub Pages”、“Cloudflare Pages”、“Netlify”、“Vercel”:使用
publish-static-site,并在之前使用review-static-site。
当用户请求完整的一键构建时,选择处理实际输入的最短链。不要仅仅因为存在就运行所有子技能。
路由示例
使用这些示例来稳定路由:
| 用户请求模式 | 路由 |
|---|---|
| “我想要一个独特的个人博客,帮我选个样式” | search-blog-theme |
| “在构建前为这个选定的样式找到真实参考” | find-style-references |
| “在这个选定的方向上给我建一个个人网站” | find-style-references -> make-personal-site -> review-static-site |
| “从头构建一个完整的个人博客” | 如果需要则 search-blog-theme -> find-style-references -> make-personal-site -> 如果内容存在则 personalize-site -> review-static-site |
| “使用这个 URL 作为参考并重建它” | copy-website-style -> personalize-site -> review-static-site |
| “复制这个网站但将其内容替换为我的” | copy-website-style -> personalize-site -> review-static-site |
| “这是我生成的网站,用我的简历/项目/链接替换占位符” | personalize-site -> review-static-site |
| “将这篇 Markdown/Obsidian/Word 文章添加到网站” | add-blog-posts -> review-static-site |
| “更改这一部分/颜色/标题/卡片/菜单” | edit-site-part;仅当共享结构或资产更改时才添加 review-static-site |
| “检查这个网站是否准备好” | review-static-site |
| “将其部署到 Cloudflare Pages/GitHub Pages/Netlify/Vercel” | review-static-site -> publish-static-site |
| “它在本地通过 HTTP 工作,但双击 index.html 不行” | review-static-site;在发布前修复路径门控失败 |
标准流水线
从创意到原创网站
当用户只有粗略目标或样式偏好时使用。
- 如果视觉方向不明确,使用
search-blog-theme。 - 使用
find-style-references将所选方向锚定在真实网站/模板/截图中。 - 使用
make-personal-site创建静态网站。 - 如果用户提供了身份/内容或网站有应填充的占位符,使用
personalize-site。 - 使用
review-static-site作为硬 QA 门控。 - 除非请求了发布,否则提供本地预览说明后停止。
从参考到个人网站
当用户提供目标 URL、截图、v0 模板、Figma 设计或要匹配的现有网站时使用。
- 使用
copy-website-style重建布局、动效、页面类型和交互。 - 使用
personalize-site替换目标身份和占位符内容。 - 如果用户提供了写作内容,使用
add-blog-posts。 - 使用
review-static-site作为硬 QA 门控。 - 除非请求了发布,否则提供本地预览说明后停止。
内容优先的博客
当用户最强的输入是文章、笔记、Markdown、Word 文件或旧的写作档案时使用。
- 仅当没有网站/主题存在时,使用
search-blog-theme。 - 如果需要新的原创视觉系统,使用
find-style-references。 - 如果尚不存在静态网站,使用
make-personal-site。 - 使用
add-blog-posts将内容导入现有网站的文章系统。 - 如果身份/个人资料内容仍为通用内容,使用
personalize-site。 - 使用
review-static-site作为硬 QA 门控。 - 除非请求了发布,否则提供本地预览说明后停止。
现有网站改进
当用户已有生成的网站文件夹时使用。
- 检查网站和
EDITING.md(如果存在)。 - 使用
personalize-site进行身份/内容替换。 - 使用
add-blog-posts进行文章导入。 - 使用
edit-site-part进行聚焦的设计或文本更改。 - 当更改影响导航、页面类型、资产、编码、发布就绪性或超过一个页面时,使用
review-static-site。
发布就绪的网站
当用户请求发布或部署时使用。
- 首先使用
review-static-site。 - 如果审查发现问题,修复障碍或路由到相关的子技能。
- 仅当网站通过必要的本地检查或用户接受已知风险后,使用
publish-static-site。 - 部署完成后验证实时 URL。
质量门控
在相关门控通过或用户接受明确限制之前,工作流未完成。
主题门控:
- 视觉方向或参考足够具体以进行构建。
- 如果构建是原创的且基于品味词,已从多个角度搜索真实的样式参考,并尽可能检查了至少 3 个强参考,或者用户明确放弃了该步骤。
- 所选方法与用户的网站类型匹配:博客、作品集、研究主页、数字花园、笔记、链接或混合型。
结构门控:
- 必需的页面类型存在,而不仅仅是主页。
- 类似博客的网站至少包含一个文章/详情页面和一个列表/归档入口。
- 导航指向真实生成的页面。
内容门控:
- 用户提供的身份/内容出现在预期位置。
- 仅含占位符的内容被明确标记或替换。
- 在样式重建中,复制的源网站身份已被移除,除非用户拥有它或拥有权限。
路径门控:
- 网站本地链接和资产默认使用页面相对路径。
- 嵌套页面使用正确的
../深度。 - HTML、CSS
url(...)、JavaScript 生成的链接、数据文件、封面图片、字体和供应商资产避免意外的根绝对路径。 - 直接打开
index.html不应丢失 CSS、JS、图片或导航。
编码门控:
...
[为翻译而截断]