Website Playbook (build-websites-v2): build or revise a site

# 网站搭建 V2 把用户要的网站做准确、做完整，并留下能继续维护的实现。先听清楚、找对项目、核对证据，再动代码。 ## 入口规则 1. **用户明确要求决定范围。** 区分“分析”“给建议”“实施”“恢复版本”“上线”。建议单独列出；未被采纳时不能偷偷成为页面、功能、文案、依赖或删改。用户已批准建议或授权本轮自主决策时，在该授权范围内连续完成，不反复求确认。 2. **参考效果先查实际实现。** 涉及还原、机制判断或反复调不对时，优先读参考站可访问的 HTML、CSS、JavaScript、运行 DOM、计算样式和关联公开源码，再核对真实交互。不能只看截图就猜技术栈、参数、触发方式或动画顺序。读不到的部分明确标为未验证。 3. **先锁定网站主体与目录。** 聊天所在目录不一定是目标站点。核对网站属于谁、代码在哪、当前分支、预览地址和正式地址；不要把另一个客户、研究项目或组织的内容混进来。 4. **保住用户认可的内容与版本。** 只改视觉不等于重写身份；喜欢一个动效不等于授权更改整站。恢复版本要找实际文件或提交，不能凭记忆重做一个“差不多”的版本。已存在的未提交改动也可能是用户认可的基线。 5. **事实可靠与允许呈现分开判断。** 找到某个真实事实，不代表可以把它加到网站。页面内容要同时有事实依据和范围依据；未知数据不猜默认值。 6. **验收实际体验。** 构建通过、HTTP 200 或一张截图都不能单独证明完成。验证指定行为、关键中间态、受影响页面和交付版本；没做的检查明确记为未验证。 ## 先做最小定位 读取目标项目的有效规则、README、当前交接、相关规格和工作区差异，记录： - 用户这次要求、明确保留项、明确不做项； - 目标目录、分支或基线、当前预览及正式站； - 本轮完成的可见证据，例如某交互恢复、某页面按参考变更、维护者能更新一篇文章。 已有信息能确定就直接执行。小修复用几行记录即可；新站或多页面重设计再用 [项目简报模板](assets/project-brief.md)。从旧项目提炼经验时，先读 [需求与证据](references/intent-and-evidence.md)，不能把历史助手的建议当作用户已确认的决定。 发现文档与当前代码、最新明确指令或真实部署不一致时，核对时间和变更证据，标出过期约定；遵守当前指令层级，不让旧产品说明覆盖用户新要求。 ## 按任务读取资料 | 当前任务 | 读取 | 这一轮交付 | |---|---|---| | 定位材料、规划新站、消除歧义 | [需求与证据](references/intent-and-evidence.md) | 已有材料预填的范围与缺口；按本轮授权决定是否继续实现 | | 找灵感、解释或还原参考效果 | [参考站与源码](references/reference-inspection.md) | 原站链接、实现证据、差异与适用范围 | | 改页面、修交互、恢复版本 | [实现与验收](references/implementation-and-qa.md) | 按本轮授权交付诊断或可运行修改、回归结果和基线 | | CMS、数据维护、部署与交接 | [内容与交付](references/content-and-delivery.md) | 本次涉及的维护链路、发布或交接材料 | | 复盘返工、维护本 Skill | [经验与边界](references/experience-ledger.md) | 有来源边界的规则修订 | 只读取当前需要的资料。修一个菜单不必启动完整品牌访谈；只分析参考站不应创建应用；用户要完成网站时，先交付网站，经验提炼不能取代主任务。 ## 参考与视觉决策 - 用户给出的参考和已认可版本优先。需要发现新参考时，从 [Awwwards](https://www.awwwards.com/) 和其 [网站作品库](https://www.awwwards.com/websites/) 按当前任务筛选，再进入作品原站核对。 - 分开记录参考的内容结构、视觉形式与交互机制。用户说“内容已定，只看 UI”，就保留内容，只研究展示方式。 - 对参考写清“借哪一部分、用在哪里、证据是什么、哪些不适用”。字体、网格、留白和动效形成统一规则，不能把多个站的局部亮点随意拼成一页。 - 克制、炫酷、黑白或科技感不是固定组件清单。不要自动加粒子、音乐、光标特效、圆底头像、计数器、会员系统，也不要擅自删除用户明确要保留的特效。 - 当用户明确要还原指定效果时，按 [源码核对流程](references/reference-inspection.md) 找出真实机制；不能用“更高级”“更简洁”替换其明确目标。 ## 实现与完成 沿用当前可靠技术栈与部署链路，尊重用户本轮指定的平台。只有当前任务确实涉及 Sites 站点的构建或托管、且环境提供对应能力时，才使用相关 Sites 工作流；`.openai/hosting.json` 只是定位线索，不单独决定工具或构成发布授权。工具缺失时说明限制，完成可行的本地工作，不臆造 API、不悄悄迁移平台或新建无关基础设施。 在可回退基线上做最小完整修改。可独立工作时按文件或模块划分并行任务，避免多个执行者改同一文件；整合后由一处核对完整体验。上线、推送、外部编辑等动作依照本轮已有授权执行。 完成时逐项对照用户要求，提供： - 已完成的可见变化和访问入口； - 做过的检查及仍未验证的部分； - 修改所在版本、维护入口，涉及发布时给出正式地址与回滚办法。 大型交付用 [交接模板](assets/handoff.md)。仅本地预览时验证服务当前可访问并留下启动命令，不承诺临时进程永久运行。没有实际部署就不写“已上线”；没有实际操作就不写“维护者已验收”。