从创意到个人网站 是做什么的?
目标
将个人网站或博客请求从初始想法转变为经过验证的本地静态站点,并可选择发布到在线URL。
这是面向用户的端到端流水线。它应选择并串联现有的专业子技能,在每个阶段后强制执行通过门,通过将故障路由到最小的责任子技能来进行修复,并仅在请求的结果实际达成或被缺失的用户/账户操作阻塞时停止。
契约
输入:
- 用户创意、参考URL、模板、截图、目标风格、个人身份资料、站点文件夹、内容草稿以及可选的发布目标。
- 可选的输出文件夹、部署平台、仓库/账户状态和自定义域名。
输出:
- 完成的本地静态站点或更新后的现有站点。
- 可选的在线部署,或当部署需要用户账户操作时提供精确的平台步骤/配置。
- 简洁的移交说明,包含使用的路由、站点文件夹、预览或在线URL、执行的验证、修改的文件以及剩余的可由用户编辑的内容。
边界:
- 当有合适的专业子技能时,不要直接实现子技能的细节。
- 除非用户明确要求执行远程操作,否则不要发布、推送、创建仓库/项目、绑定域名或更改DNS。
- 不要在生成、重建、个性化、导入后、大规模编辑后或部署前跳过验证。
- 当缺少用户资料时,不要编造详细的个人事实;应使用可编辑的占位符并记录它们。
成功门:
- 站点达到用户请求的终点:经验证的本地站点、可发布的包或经过验证的在线URL。
- 所有相关阶段门均已通过,或者未解决的风险已被用户明确了解并接受。
如果门失败:
- 将故障路由到最小的责任子技能。
- 重新运行受影响的验证。
- 仅在缺失内容、缺失凭据、账户权限、不可用资源或外部平台操作阻止进度时才询问用户。
子技能
将已安装的技能作为构建块使用:
search-blog-theme:用于方向不明确、风格探索或参考选择。find-style-references:用于将选定的方向落实到真实的网站、模板、截图以及可构建设计摘要中。make-personal-site:用于生成原始、无依赖的静态站点。copy-website-style:用于重新创建特定的网站、模板、截图或视觉系统。personalize-site:用于替换占位符、复制的身份、元数据、链接和个人简介内容。add-blog-posts:用于导入Markdown、Obsidian笔记、Word草稿、旧文章、资源、数学公式、链接和富文本文章内容。edit-site-part:用于在循环过程中发现的集中修复或小的本地调整。review-static-site:用于确定性验证和浏览器验证。publish-static-site:用于发布准备或部署。build-personal-site:仅当需要更底层的路由决策时使用。
不要预先加载所有子技能。仅当流水线到达该阶段时才加载下一个子技能。
默认流水线
对于宽泛的“从创意到网站”或“一键式个人博客”请求,使用以下闭环:
-
澄清终点。 输入:用户请求和可用资料。 输出:路由计划和预期终点:本地站点、可发布站点或在线部署。 门:站点类型、可用输入和停止点足够清晰,可以开始行动。
-
选择方向。 输入:创意、品味、示例、受众或参考资料。 输出:具体的视觉/站点方向。 门:方向足够具体,可以开始构建。 如果不明确:使用
search-blog-theme。 -
在参考中扎根风格。 输入:选定的方向、主题词或用户示例。 输出:具体的参考集和可构建设计摘要。 门:摘要基于多个搜索角度,并在可能的情况下至少检查了3个强有力的参考,且足够具体以进行构建。 在原始构建之前使用
find-style-references,除非用户提供了用于精确复制的特定参考网站。 -
创建或重新创建站点。 输入:方向或参考URL/截图/模板。 输出:包含代表性页面和
EDITING.md的静态站点文件夹。 门:所需的页面类型存在,并且导航指向真实页面。 对于原始站点使用make-personal-site。 对于特定参考使用copy-website-style。 -
个性化内容。 输入:生成的站点加上用户身份、简历、链接、项目、头像、简历或提供的个人资料。 输出:站点内容和元数据反映用户信息,并移除了从源复制来的身份信息。 门:用户提供的信息出现在预期区域,且源/演示残留已被清除。 当需要替换身份或占位符时使用
personalize-site。 -
添加写作内容。 输入:生成的或现有的站点加上文章草稿、笔记、Markdown、Word文件、图片文件夹、数学公式、引文和链接。 输出:文章/详情页面、更新后的索引、复制的资源以及文章特定的注释。 门:文章渲染正常,链接、资源、数学公式、代码和响应式布局正常工作。 当提供写作内容时使用
add-blog-posts。 -
验证。 输入:静态站点根目录、预期的页面范围、禁止的源字符串以及可选的参考URL。 输出:通过/失败报告或修复。 门:
review-static-site没有关于路径、编码、隐私残留、页面类型、浏览器渲染、控制台/网络错误或移动可用性的阻塞问题。 如果门失败:使用最小的子技能进行修复,然后重新运行受影响的验证。 -
发布或准备。 输入:经过验证的静态根目录加上所需的平台或账户约束。 输出:部署设置/配置、手动步骤或在线URL。 门:部署根目录正确,且在线或准备好的站点使用了正确的文件夹。 仅在用户要求发布、部署或准备发布时使用
publish-static-site。 -
移交。 输入:完成的站点以及验证/部署结果。 输出:简洁的最终摘要,包含站点的位置、如何预览或打开它、已执行的验证以及用户下一步可以编辑的内容。
路由快捷方式
- 仅模糊创意:
search-blog-theme->find-style-references->make-personal-site->review-static-site。 - 选定的方向:
find-style-references->make-personal-site-> 如有需要personalize-site->review-static-site。 - 参考网站/模板/截图:
copy-website-style->personalize-site->review-static-site。 - 现有站点加上个人资料:
personalize-site->review-static-site。 - 现有站点加上文章:
add-blog-posts->review-static-site。 - 现有站点加上一项精确更改:
edit-site-part-> 受影响的浏览器验证,如果共享结构有变化则进行review-static-site。 - 发布请求:
review-static-site->publish-static-site。 - 完整的从创意到发布请求:选择方向 -> 查找参考 -> 创建/重新创建 -> 个性化 -> 如果提供了文章则添加 ->
review-static-site->publish-static-site。
一键式默认值
当用户请求完整的站点但未明确选择时:
- 对于此版本,默认使用纯静态HTML/CSS/JS。
- 输出文件夹默认使用用户请求的文件夹,否则使用工作区中清晰的本地
site/文件夹。 - 默认显示有用的首屏,而非营销着陆页。
- 对于缺失的个人信息,默认使用可编辑的占位符。
- 在根据品味词构建之前,默认研究真实的风格参考。
- 默认使用页面相对路径,以兼容直接打开、本地HTTP和子路径部署。
- 在任何发布步骤之前,默认进行本地验证和预览。
- 如果用户询问在哪里发布但没有偏好,则默认提供Cloudflare Pages或GitHub Pages的纯静态发布指导。
门循环
在每个阶段之后:
- 检查阶段门。
- 如果通过,继续。
- 如果失败,将故障路由到能够修复它的最小子技能。
- 仅重新运行相关验证。
- 继续直到达到终点或仍然存在外部阻塞因素。
常见阻塞处理:
- 个人信息缺失:保留中性占位符并记录它们,除非用户希望暂停。
- 文章资源缺失:保留文章,在
EDITING.md中标记缺失资源并进行报告。 - 平台登录或权限缺失:准备精确的发布步骤,而不是假装部署已发生。
- 隐私或路径阻塞:在发布前修复。
最终报告
保持最终响应简短:
- 使用的路由。
- 站点文件夹。
- 预览URL、本地文件或在线URL。
- 创建或更新的主要页面/内容。
- 执行的验证。
- 发布状态以及任何需要的用户操作。
除非用户要求,否则不要粘贴冗长的审核日志。