Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 6.04 KB

verification.md

File metadata and controls

60 lines (43 loc) · 6.04 KB

验证与交付

选择与改动相关的检查,不为文案小修改反复跑完整套件。除 AI 按 SKILL.md 规则代为启动的本地预览外,默认不启动网站、服务、浏览器或后台进程。

静态可验证项

  • Skill:frontmatter 合法、相对引用存在、无开发机绝对路径依赖、无未知工具硬依赖;借鉴文件有来源和许可。
  • Astro:安装版本与锁文件一致,静态检查、相关单元测试和静态构建;枚举生成页面,确认详情、分类和分页完整。
  • HTML:解析生成结果检查 title、description、canonical、robots、html lang、内部链接与 JSON-LD;不要用正则替代 HTML/XML/JSON 解析器。
  • sitemap 与 robots:内容和索引开关一致,无 404 或 noindex URL;预览与生产设置明确区分。
  • CMS:脱敏 fixture 测试字段映射、分页、缺译文、404 与暂时失败;未连真实接口时写清楚。
  • 部署:验证 static 不加载适配器、server 选择正确平台、无效配置明确失败。适配器选择单元测试不等于真实平台部署成功。
  • static 询盘:检查入口生成/切换、运行时配置、来源与请求校验、失败及未知回执;保存、spam 与通知结果分别测试。当前 RXCMS 不返回普通通知结果,不能伪造 sent/delivered。按客户阶段做真实记录与邮件验收,skill 开发只用脱敏测试。
  • Consent:分别验证未同意、拒绝、统计同意、广告同意、撤回、回访及关闭开关;静态测试不能证明浏览器网络或 Cookie 行为。说明手工第三方脚本不在当前控制范围。
  • server 构建可能需要平台运行时。若构建会启动本地模拟服务,未经用户允许不执行;报告已做静态检查及尚缺的实际构建/预览验证。
  • WordPress API:按脱敏 fixture 检查认证、分页、公开内容筛选、字段/媒体/链接映射、HTML 清理及失败处理;确认凭证只在构建/服务端读取,不声称已完成真实接口联调。

上线前检查清单(新建站交付前逐项检查,用业务语言向用户报告)

内容真实

  • 示例产品、演示文字、占位图片都已替换;公司名、地址、电话、邮箱正确。
  • 产品参数、认证、产能、客户案例都来自用户资料;没有证据的说法已删除或列入待补。
  • 隐私政策已按用户实际情况补充。

页面与转化

  • 每页有明确的下一步(询价、看产品、下载),按钮都对应已实现的动作,没有假入口。
  • 询盘方式可用:邮件链接地址正确,或站内表单已按 inquiry 配置。
  • 导航 4–7 项,重要页面离首页 3 次点击以内,没有孤立页面和断链。

SEO

  • 每页 title、description 唯一且长度合适,每页一个 H1。
  • 产品图有描述性 alt,图片已压缩(首屏大图约 200KB 以内)、写明尺寸,首屏主图不懒加载。
  • 结构化数据只含真实信息,无占位文字、无编造的价格或评价。
  • 多语言站:各语言页面文字都已翻译并请人核对术语;缺译文的页面没有生成。
  • site 已改成正式域名;资料确认真实后才开启 indexable。

品牌与体验

  • 网站小图标已换成客户 Logo;有分享图时已设置。
  • 手机上导航可用、无横向滚动、Cookie 弹窗不挡住主要内容(需用户预览确认)。

发布后(用户操作后确认)

  • 正式网址能通过 https 打开,浏览器没有证书错误或“不安全”警告。
  • 改一处内容并推送后,网站能自动更新。
  • 已提交 Google Search Console,站点地图状态为“成功”。

需要运行或外部环境才能验证

响应码、重定向、跨域与表单到达、CMS 实际更新、视觉响应式、运行时密钥、平台预览及域名。只有实际观察后才写“已验证”。未经授权不发送测试询盘给真人、不写生产 CMS、不部署生产。

涉及视觉或交互改动时,按 B2B 设计说明 检查采购路径。选取本次涉及的首页、产品列表/详情或联系页,用长产品名、缺图片和真实规格检查可读性;在用户已启动或明确授权的预览中检查窄屏、文字放大、菜单、表格、键盘焦点,以及固定控件与 Cookie 弹窗的遮挡。表单反馈先用隔离测试,真实询盘另按客户授权验收。记录具体页面、检查条件和问题,不以构建通过代替视觉验收。

入门指南也需要推演:GitHub 注册与验证、以公司英文名命名的网站仓库、Commit 后 Push、Vercel 登录和仓库授权的区别、Cloudflare 邮箱注册后连接 GitHub、独立根目录选择、CMS 更新不自动触发 Git 部署。整包审核包括代码、文档、fixture、部署示例、开源许可和能力声明。

行为场景

零基础场景:用户只提供公司和产品,且不知道安装、后台、平台或终端是什么。检查从取得 skill、安装、触发、准备资料、默认选择、生成网站、用户预览到发布更新的路径是否可走通;每个需要用户操作的步骤是否说清位置、动作、完成标志,是否混淆终端与 AI 对话、skill 目录与网站目录。审核整个 skill 的指令与真实实现,不只润色 README;文档易读不能抵消接口、构建、部署或能力声明的问题。

审核 skill 时至少推演:新站未选内容源时默认本地纯静态且不索要 key;已选 CMS 不重复询问;要求后台但未选 CMS 时询问;已选 CMS 缺凭证时不静默回退;新站未选发布平台;CMS + static 重建;明确 server + Vercel;切换 server 到 Cloudflare;已有 server 站只改 SEO;WordPress API + 环境变量;CMS 失败;多语言缺译文。检查生成 README 的实际选择是否与代码一致,是否保持任务范围、正确表达依赖和未验证项。

交付说明包含实际改动、当前模式/平台、执行的检查及结果、剩余接入步骤。不能把生成模板、静态测试、真实部署混称为完成上线。