造站手册是什么
「造站手册 · Website Playbook」是一套面向 AI 建站助手的工作方法，当前版本为 2.0.1，主要在 Codex 环境中验证。它不是网站框架、CMS 或托管平台，而是一组帮助 Agent 正确理解需求、核对参考实现、保护现有项目并完成验收与交接的执行规则。
它适用于个人网站、作品集、研究与组织网站、内容站，也可用于已有网站的改造和局部修复。除核心工作流程外，项目还提供 16 条匿名经验，以及项目简报和网站交接两份模板。
核心能力与工作原则
守住需求范围
造站手册要求区分三类信息：用户明确提出的要求、完成任务所需的实现细节，以及可以讨论但未经确认的建议。这样可以减少 AI 擅自增加栏目、功能或文案的问题。
先核对参考实现
可以先从 Awwwards 寻找设计灵感，再访问作品原站，核对可访问源码和真实交互。视觉参考不应只停留在截图层面，还要确认菜单、滚动、动效和响应式行为如何工作。
保护已认可版本
修改已有网站之前，应先定位正确的项目和基线，识别需要保留的内容以及尚未提交的改动。未经确认，不应直接覆盖用户已经认可的版本。
验收真实体验
验收不只是确认页面能够打开。应根据任务范围检查手机显示、键盘操作、菜单状态、动效过程和失败状态，并明确记录哪些项目经过了实际测试，哪些仍未验证。
留下维护路径
交付网站时，应说明内容在哪里更新、修改何时生效、如何发布，以及出现问题时如何回退。这样交付结果才能继续维护，而不是只能由当前执行者操作。
安装前的准备
使用该 Skill 前，需要具备可使用 Skill 的本地环境。具体网站项目还需要相应的内容、开发环境、工具权限和验收条件。由于项目主要在 Codex 中验证，README 并未承诺所有 AI 平台都完全兼容。
你可以查看 v2.0.1 版本说明，也可以直接下载 v2.0.1 完整 Skill 包。
方法一：让 Codex 安装 Skill
将下面的指令交给 Codex。指令中特别要求在遇到同名版本时先检查自定义改动，避免直接覆盖已有内容。
使用 skill-installer，从 https://github.com/7-an/website-playbook/tree/v2.0.1/skills/build-websites-v2 安装这个 Skill。
若已存在同名版本，先检查并保留我的自定义改动，不直接覆盖。安装完成后，建议新开一个任务再调用 Skill，避免之前对话中的上下文干扰需求范围。
方法二：手动安装 ZIP
- 下载 v2.0.1 完整 Skill 包。
- 解压下载的 ZIP 文件。
- 找到完整的
build-websites-v2文件夹。 - 将整个文件夹放入本机支持的 Skill 目录。
- 确认其所有子目录和文件都被保留。
不要只复制
SKILL.md。该 Skill 还依赖 README、调用元数据、参考资料和模板资源。
关于 Skill 的安装与发现机制，可阅读 官方说明。
认识项目文件结构
skills/build-websites-v2/
├── SKILL.md # Agent 执行入口
├── README.md # 安装、示例与能力边界
├── agents/openai.yaml # 调用元数据
├── references/ # 5 份按需参考，含匿名经验账本
└── assets/ # 项目简报、网站交接模板SKILL.md 是 Agent 的执行入口，但完整工作方式还依赖其他目录。references 保存按需使用的参考资料，assets 则包含项目简报和网站交接模板。
第一次调用造站手册
项目的公开名称是「造站手册」，现有调用名仍保留为 build-websites-v2，以兼容已经安装的用户。安装后，可在新任务中使用以下格式：
使用 $build-websites-v2，帮我制作或修改网站。
目标：……
已有资料与项目路径：……
参考网站及希望借鉴的部分：……
必须保留：……
本轮范围：分析 / 本地实现 / 发布。这份输入结构的重点是让目标、项目位置、参考对象、保护项和执行范围彼此分离。不要只说“帮我做得更好看”，而应指出具体页面、期望效果以及禁止改动的区域。
示例：制作一个作品集网站
使用 $build-websites-v2，帮我制作网站。
目标：制作一个个人作品集网站，用于展示研究项目和设计作品。
已有资料与项目路径：项目位于本地指定目录，文案和作品资料已整理。
参考网站及希望借鉴的部分：参考指定网站的首页节奏和项目列表布局，不复制其图片、字体或代码。
必须保留：现有个人简介和项目名称。
本轮范围：先分析，再进行本地实现，不发布。示例：修改已有网站
使用 $build-websites-v2，帮我修改网站。
目标：修复移动端菜单无法正常关闭的问题。
已有资料与项目路径：项目位于本地指定目录。
参考网站及希望借鉴的部分：无。
必须保留：首页内容、桌面端导航样式和当前未提交改动。
本轮范围：本地实现与相关验收，不发布。第二个例子把任务限制在菜单修复，不要求重新设计整站。造站手册支持这种局部任务，不必每次都执行完整建站流程。
按任务选择执行范围
调用时可将本轮范围明确为分析、本地实现或发布，也可以组合多个阶段。
- 仅分析：用于研究参考网站、梳理需求或检查现有项目，不直接修改代码。
- 本地实现：在确认项目和基线后修改网站，并进行任务相关的本地检查。
- 发布：需要具备相应权限，并在发布前确认交付内容和风险。
- 局部修复：只处理菜单、交互或指定问题，避免扩大改动范围。
- 版本恢复：明确要恢复的版本或基线，同时保护其他现有改动。
进阶使用技巧
明确“借鉴什么”
提供参考网站时，不要只提交网址。应说明希望借鉴的是布局、信息层级、菜单行为、动效节奏还是其他具体部分。公开可读的源码不代表代码、字体和图片可以任意复制，复用前需要遵守相应许可。
把保护项写进提示词
如果项目已有认可版本，应明确列出必须保留的页面、文案、交互和未提交改动。安装同名 Skill 版本时也应采用相同原则：先检查差异，再决定如何更新，而不是直接覆盖。
要求给出验收记录
可以要求 Agent 在完成后列出实际测试项，例如是否检查手机布局、键盘操作、菜单开合、动效全过程和失败状态。如果浏览器、参考源码或外部资源不可访问，应将其标记为未验证，而不是假定已经通过。
把交接作为任务的一部分
在提示词中加入交接要求，让最终结果说明内容更新位置、生效条件、发布步骤和回退方式。项目内的交接模板可以帮助整理这些信息。
先分析，再授权实施
当参考复杂、现有项目不熟悉或改动风险较高时，可以先限定为“仅分析”。确认分析结果和范围后，再开启本地实现或发布任务。这种分阶段方式有助于降低误改风险。
能力边界与注意事项
- 该项目提供的是工作方法与执行规则，不会替代网站内容、开发环境和必要权限。
- 它不强制采用特定框架、CMS 或托管平台。
- 安装 Skill 不等于获得网站部署授权，发布仍取决于实际权限。
- 无法访问参考源码或浏览器时，应记录未验证项。
- 公开内容只包含通用方法、匿名经验和空白模板，不包含原始聊天、客户素材、私人账号或内部审计记录。
- 项目主要在 Codex 环境中验证，尚未完成全平台兼容验证。
结语
造站手册的价值不在于替你选择技术栈，而在于规范 AI 建站过程：先听清需求和范围，再核对参考实现，保护已有版本，完成与任务匹配的真实验收，最后留下可维护、可发布和可回退的交接路径。安装 build-websites-v2 后，从一个目标明确的小任务开始，通常比直接要求 AI 重做整站更稳妥。