Communitygithub.com

网站精修导演 — 五关上线前出货

上线前对任意网站做结构化五关精修审计——视觉打磨、技术底座、UX 完整度、内容质量、跨设备就绪,百分制打分。

网站精修导演 — 五关上线前出货 是什么?

Landing Pages 配方第 3 步(精修/出货):skills-website-finishing-director。CRO 工艺与电影感搭建之后,给视觉/技术/UX/内容/设备就绪打分,放行落地页上线。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cody-W-Tucker/skills/tree/HEAD/skills/website-finishing-director

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

网站收尾主管

结构化的 5 遍网站收尾审核——从第一印象到发布就绪——按 100 分制评分。就像绘画:底漆、底涂层、细节、清漆、终检。未经收尾审核的网站不得上线。

何时使用此技能

  • 发布前关口 — 在 DNS 生效或流量引入之前进行最终验证
  • 重新设计后审核 — 在视觉改造后,确认没有出现退化
  • 客户交接 — 生成一份结构化的报告,证明网站符合质量标准
  • 季度维护 — 发现累积的 UX 债务、失效链接、陈旧内容
  • 针对性检查 — 仅运行一遍检查(例如,在性能优化后仅运行“第 2 遍”)

方法论基础

来源:

  • Nielsen Norman Group — 启发式评估框架(10 项可用性启发式)
  • Google Web Vitals — LCP、CLS、INP 阈值
  • OWASP — 安全标头基线
  • Oli Gardner / Unbounce — 着陆页转化最佳实践
  • Don Norman — 情感化设计(本能/行为/反思层)
  • GUIA 生产经验 — 8 个已上线网站,记录了涵盖 Next.js、Framer Motion、GSAP、Lenis、Railway、Docker 的各种陷阱

核心原则: 一个通过 Lighthouse 测试且元标签正确的网站在技术上是有效的,但并未完成。“完成”是介于“它能工作”和“它已就绪”之间的差距。它需要像访客体验网站那样进行评估——递进的、情感化的、跨设备的——而不是作为一系列独立指标的清单。

为何重要: 现有工具(Lighthouse、Screaming Frog、Awwwards)各自只审核一个维度。没有工具能在连续、评分的工作流中结合视觉打磨、UX 完整性、技术基础、内容质量和品牌一致性。本技能正是这样的工具。


Claude 做什么 及 你决定什么

“Claude 执行审核。你决定什么上线。”

Claude 处理你提供
系统地对照清单运行每一遍检查实时 URL 或代码库访问权限
根据原理对每个检查点进行评分背景信息:品牌定位、目标受众、发布时间表
将问题分类为 P0/P1/P2覆盖决策(例如,“P1 对于 MVP 可接受”)
生成包含修复建议的最终报告最终的“通过/不通过”判断
根据生产经验标记 GUIA 技术栈的陷阱在真实设备上进行验证(Claude 无法打开 Safari)

请记住: 这是一个半人马工作流。Claude 严格组织审核;你在真实设备上用肉眼验证裁决。


此技能的功能

  1. 5 秒第一印象测试 — 在最初时刻评估清晰度、情感契合度和 CTA 可见性
  2. 技术基础审核 — 性能(核心 Web 指标)、SEO 基础、安全标头、失效链接
  3. UX 完整性检查 — 组件状态、表单行为、动画打磨、移动端可用性
  4. 内容与品牌验证 — 文案质量、占位符检测、语气一致性、视觉连贯性
  5. 跨设备与发布就绪检查 — 浏览器测试、OG 预览、分析工具、404 页面、网站图标

如何使用

发布前的完整网站审核

我将要发布 [网站 URL]。执行一次完整的网站收尾主管审核(全部 5 遍)。
品牌象限:[温暖+平静 / 温暖+活跃 / 冷静+活跃 / 冷静+平静]。
目标受众:[谁]。

特定修复后的单遍检查

我刚对 [网站 URL] 进行了性能优化。仅运行第 2 遍(技术基础)。

着陆页快速审核

审核此着陆页:[URL]。使用着陆页配置(第 1、2、4 遍)。

操作说明

执行此审核时,请按顺序执行 5 遍检查。每遍检查建立在前一遍的基础上——先打基础再抛光。对每个检查点进行评分,按优先级对问题进行分类,然后生成最终报告。

审核配置

并非每个网站都需要全部 5 遍检查。选择与项目匹配的配置:

配置检查遍数何时使用
着陆页1、2、4单页营销活动或产品页面
完整网站1、2、3、4、5包含导航、表单、内容的多页面网站
电子商务2、3、5包含购物车、结账、产品页面的商店

使用精简配置时,按比例调整总分。通过/不通过阈值适用于百分比分数,而非原始分数。


第 1 遍:第一印象(15 分)

“访客在 5 秒内理解和感受到什么?”

展示主页(或英雄区域)5 秒。回答以下 5 个问题,每个 3 分:

## 第 1 遍 — 第一印象(5 秒测试)

### 1. 这是**什么**?(3 分)
访客能否识别该网站/产品/服务是什么?
[ ] 3 — 立即清晰,无歧义
[ ] 2 — 阅读副标题后清晰
[ ] 1 — 模糊,需滚动才能理解
[ ] 0 — 完全不知道这是什么

### 2. 它是为**谁**设计的?(3 分)
是否有信号表明目标受众?
[ ] 3 — 明显的人口/心理特征信号
[ ] 2 — 隐含但未明确说明
[ ] 1 — 泛化(“所有人”)
[ ] 0 — 令人困惑(信号指向错误受众)

### 3. 我**为什么**要在意?(3 分)
价值主张或益处是否可见?
[ ] 3 — 清晰的益处,情感共鸣
[ ] 2 — 侧重功能但可理解
[ ] 1 — 存在但被埋没
[ ] 0 — 无可视价值主张

### 4. 我**接下来做什么**?(3 分)
主要 CTA 是否可见且清晰?
[ ] 3 — CTA 在折叠线以上可见,操作特定文本
[ ] 2 — CTA 存在但泛化(“了解更多”)
[ ] 1 — CTA 在折叠线以下或难以找到
[ ] 0 — 无可见 CTA

### 5. 感觉**如何**?(3 分)
情感基调是否与品牌象限匹配?
[ ] 3 — 完美象限匹配(温暖品牌 = 温暖设计)
[ ] 2 — 基本一致,轻微不协调
[ ] 1 — 明显不匹配(温暖品牌 + 冷静设计)
[ ] 0 — 相反象限(定位混淆)

### 第 1 遍得分:___/15

判定:
- 12-15:通过 — 第一印象清晰且情感一致
- 8-11:需要改进 — 访客能理解,但缓慢或有摩擦
- <8:失败 — 重新设计折叠线以上的体验

整合: 将情感感受与 web-design-director 象限系统进行对比。如果品牌是“温暖+平静”但网站感觉“冷静+活跃”,则无论分数如何,均为 P0。

此遍检查的 GUIA 陷阱:

  • CTA 中硬编码了 Calendly URL 而非 /contact/ 页面(破坏分析)
  • 混合温暖文案基调与冷静 UI 元素(陶土色配色 + 等宽字体 = 混淆)

第 2 遍:技术基础(25 分)

“基础设施是否足够稳固以构建其上?”

## 第 2 遍 — 技术基础

### 性能(10 分)

| 指标 | 目标 | 得分 |
|--------|----------|-------|
| LCP(最大内容绘制) | ≤ 2.5 秒 | 0-3 分 |
| INP(与下一次绘制的交互) | ≤ 200 毫秒 | 0-2 分 |
| CLS(累积布局偏移) | ≤ 0.1 | 0-2 分 |
| Lighthouse 性能得分 | ≥ 85 | 0-3 分 |

评分:
- LCP:3 = ≤2.5s,2 = ≤4.0s,1 = ≤6.0s,0 = >6.0s
- INP:2 = ≤200ms,1 = ≤500ms,0 = >500ms
- CLS:2 = ≤0.1,1 = ≤0.25,0 = >0.25
- Lighthouse:3 = ≥90,2 = ≥85,1 = ≥70,0 = <70

### SEO 基础(8 分)

- [ ] (2 分) 定义了规范 URL 且尾随斜杠一致
- [ ] (1 分) 每个页面的元标题唯一(≤60 字符)
- [ ] (1 分) 每个页面的元描述存在(≤160 字符)
- [ ] (1 分) Sitemap.xml 可访问且有效
- [ ] (1 分) robots.txt 存在且正确
- [ ] (1 分) 结构化数据存在(JSON-LD)
- [ ] (1 分) 所有图片均有替代文本

### 安全性与链接(7 分)

- [ ] (2 分) 强制 HTTPS(无混合内容)
- [ ] (2 分) 安全标头存在(CSP、X-Frame-Options、HSTS、X-Content-Type-Options)
- [ ] (1 分) 无损坏的内部链接(404)
- [ ] (1 分) 无损坏的外部链接
- [ ] (1 分) 生产环境中无暴露的源码映射或调试端点

### 第 2 遍得分:___/25

判定:
- 21-25:稳固 — 可以发布
- 16-20:可接受 — 修复 P0,P1 放入待办列表后发布
- 11-15:脆弱 — 显著技术债务
- <11:已损坏 — 请勿启动

此遍检查的 GUIA 陷阱:

  • next.config.js 中缺少 trailingSlash: true(导致 Rental-CRM 在 2026 年 1 月被取消索引)
  • 在 'use client' 组件上使用 export const metadata(元数据未在服务端渲染)
  • 模块级 SDK 初始化(Supabase/Stripe)在缺少环境变量时构建失败——应在函数内进行惰性初始化
  • Vercel 环境变量因 echo 命令产生尾随换行符——应使用 printf 代替
  • Railway 的 *.railway.internal 主机名在 Nixpacks 构建期间无法访问——应使用公共 URL

第 3 遍:UX 完整性(25 分)

“网站是否能处理真实世界的使用场景,而不仅仅是理想路径?”

## 第 3 遍 — UX 完整性

### 组件状态(8 分)

对于**每个**交互式组件(按钮、卡片、表单、模态框、列表):
- [ ] (2 分) 加载状态 — 骨架屏、旋转器或渐进式渲染
- [ ] (2 分) 错误状态 — 清晰消息 + 恢复操作
- [ ] (2 分) 空状态 — 有帮助的消息,而非空白屏幕
- [ ] (2 分) 成功状态 — 确认反馈

评分:根据所有组件缺失的状态进行扣分。
8 分 = 所有状态均已覆盖。每个缺失状态扣 1 分(最低 0 分)。

### 表单(6 分)

- [ ] (1 分) 带清晰错误消息的客户端验证
- [ ] (1 分) 服务端验证(不仅限于客户端)
- [ ] (1 分) 提交后的成功反馈(toast、重定向或内联)
- [ ] (1 分) 提交按钮在处理期间禁用(防止重复提交)
- [ ] (1 分) 垃圾邮件防护(蜜罐、reCAPTCHA 或速率限制)
- [ ] (1 分) 表单附近的隐私政策链接(GDPR)

### 动画打磨(6 分)

- [ ] (1 分) 滚动动画使用 `viewport={{ once: true }}`(滚动回看时不会重播)
- [ ] (1 分) GSAP 动画使用 `useGSAP` 钩子(而非 `useEffect`)
- [ ] (1 分) 尊重 `prefers-reduced-motion`(禁用或减少动画)
- [ ] (1 分) 无动画阻止内容访问(即使动画失败,内容仍可见)
- [ ] (1 分) Lenis 正确初始化(非 Locomotive Scroll)
- [ ] (1 分) 退出动画不会导致布局偏移

### 移动端可用性(5 分)

- [ ] (1 分) 触摸目标 ≥ 44px(iOS HIG 标准)
- [ ] (1 分) 无水平溢出 / 水平滚动
- [ ] (1 分) 正文字体大小 ≥ 16px(防止 iOS 缩放)
- [ ] (1 分) 粘性/固定元素不重叠内容
- [ ] (1 分) 滚动行为正确工作(无困住用户的滚动劫持)

### 第 3 遍得分:___/25

判定:
- 21-25:完整 — 真实世界使用场景已覆盖
- 16-20:基本就绪 — 需关注边缘情况
- 11-15:不完整 — 用户将遇到死胡同
- <11:未完成 — UX 未达到生产就绪

此遍检查的 GUIA 陷阱:

  • GSAP + React 18 严格模式在开发中会触发两次动画(使用 useGSAP,而非 useEffect)
  • 全局 CSS a { color: var(--color-coral) } 会覆盖锚点 CTA 上的 Tailwind text-white——应使用内联 style={{ color: 'white' }}
  • Framer Motion 的 AnimatePresence 退出动画与 Next.js App Router 冲突
  • 太多同时运行的 ScrollTrigger 实例会拖慢移动端性能
  • Lenis 包名:npm install lenis(而非 @studio-freight/lenis)

第 4 遍:内容与品牌(20 分)

“内容是否完成、一致且符合品牌调性?”

## 第 4 遍 — 内容与品牌

### 文案质量(8 分)

- [ ] (2 分) 未检测到占位符文本(“Lorem ipsum”、“[你的名字]”、“即将推出”、
      “example.com”、“TODO”、空白部分)
- [ ] (1 分) 无拼写或语法错误
- [ ] (1 分) 链接文本具有描述性(非“点击此处”或裸 URL)
- [ ] (1 分) CTA 文案具体(“开始免费试用”而非“提交”)
- [ ] (1 分) 标题层级逻辑合理(H1 → H2 → H3,每页一个 H1)
- [ ] (1 分) 替代文本具有描述性(非“image1.png”或空白)
- [ ] (1 分) 电话号码、电子邮件、地址是真实的(非占位符)

### 品牌语气(6 分)

- [ ] (2 分) 语气与品牌定位匹配(温暖/冷静、正式/随意)
- [ ] (2 分) 所有页面的语气一致(同一个人“说话”)
- [ ] (1 分) 无 AI 润色痕迹(“请随时联系我们”、
      “在当今快节奏的世界里”、“需要注意的是”)
- [ ] (1 分) CTA 与情感象限匹配(温暖品牌 = 邀请式 CTA,而非侵略性)

### 视觉一致性(6 分)

- [ ] (1 分) 颜色板使用一致(无非品牌颜色)
- [ ] (1 分) 字体层级清晰(展示、标题、正文、说明 — 最多 2-3 种字体)
- [ ] (1 分) 间距节奏一致(各部分之间无随机内边距)
- [ ] (1 分) 图标风格统一(不要混合轮廓、填充和表情符号)
- [ ] (1 分) 图片处理一致(所有照片使用相同滤镜/色调,或全部为插图)
- [ ] (1 分) 组件风格一致(卡片、按钮、输入框遵循相同模式)

### 第 4 遍得分:___/20

判定:
- 17-20:精美 — 内容已完成且符合品牌调性
- 13-16:良好 — 存在微小不一致,可以发布
- 9-12:粗糙 — 内容需要编辑整理
- <9:未完成 — 主要内容缺失或品牌不匹配

此遍检查的 GUIA 陷阱:

  • Calendly URL 必须匹配正确的专业人员(Valeria vs Matthieu vs 客户)
  • 混合温暖文案(“我们理解您的挑战”)与冷静 UI(深色模式、等宽字体、尖锐边角)
  • AI 生成内容检测:发布前删除双换行符(LinkedIn 上的 AI 特征)
  • credou.bzh 文案方向:机制优先,无个人履历,无职业生涯/时间线

第 5 遍:跨设备与发布(15 分)

“它是否在所有地方都工作,并且一切是否已准备好上线?”

## 第 5 遍 — 跨设备与发布

### 浏览器测试(5 分)

在 3 个主要浏览器上测试。每个浏览器得分:
- [ ] (2 分) Safari — 正确渲染、动画工作、字体加载
- [ ] (2 分) Chrome — 正确渲染、动画工作、字体加载
- [ ] (1 分) Firefox — 正确渲染、无重大中断

每个浏览器检查:布局、动画、字体、表单、滚动行为。
每个有视觉错误的浏览器扣 1 分。每个有功能性错误的浏览器扣 2 分。

### 设备测试(4 分)

- [ ] (2 分) 移动端(375px)— 完整网站正

…

[因翻译截断]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Cody-W-Tucker/skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, conversion rate, or landing page optimization.

Cody-W-Tucker/skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, or TikTok campaign.

Cody-W-Tucker/skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, Demand Gen, and Connected TV formats. Covers VAC→Demand Gen migration, Shorts creative requirements, and CTV shoppable ads. Use when user says YouTube Ads, video ads, pre-roll, bumper ads, YouTube campaign, Shorts ads, or CTV ads.

Cody-W-Tucker/skills

Craft the story that makes investors say \"I want in.\" Master the narrative structure that Reid Hoffman, Sequoia, and top founders use to raise capital. Use when: **Preparing to fundraise** to develop your story before the deck; **Investor meetings** to structure conversations that convert; **Pitch practice** to refine your narrative arc; **Cold outreach** to write compelling investor emails; **Pivoting** to reframe your story after a change

Cody-W-Tucker/skills

Identify the best GTM motions and tools across 7 motion types: Inbound, Outbound, Paid Digital, Community, Partners, ABM, and PLG. Use when selecting marketing channels, choosing between inbound and outbound strategy, or planning cross-channel campaigns.

Cody-W-Tucker/skills

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Cody-W-Tucker/skills

Optimize landing pages for maximum conversions using proven frameworks from Unbounce and Oli Gardner—apply the \"one goal, one message, one action\" principle with data-driven design, copy, and CTA best practices. Use when: **Create a new landing page** for a campaign; **Optimize an existing landing page** that isn't converting; **Review landing page design** before launch; **Improve form conversion rates** on lead gen pages; **A/B test landing page elements** systematically

Cody-W-Tucker/skills

Advanced motion patterns for React / Next.js — drag & drop, gestures, text animations, SVG path drawing, custom hooks, imperative sequences (useAnimate), loaders, and the full API decision tree. Requires motion-foundations.

Cody-W-Tucker/skills

Motion tokens, spring presets, performance rules, device adaptation, accessibility enforcement, and SSR safety for React / Next.js using motion/react. Foundation layer — all other motion skills depend on this.

Cody-W-Tucker/skills

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Cody-W-Tucker/skills

Production-ready animation patterns for React / Next.js — button, modal, toast, stagger, page transitions, exit animations, scroll, and layout — built on motion-foundations tokens and springs.

Cody-W-Tucker/skills

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

Cody-W-Tucker/skills

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Cody-W-Tucker/skills

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Cody-W-Tucker/skills

Best practices for Remotion - Video creation in React. 29 domain-specific rules covering 3D, animations, audio, captions, charts, transitions, and more.

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Cody-W-Tucker/skills

Master April Dunford's 8-step sales narrative from \"Sales Pitch\" (2023). Transform your positioning into a compelling story that wins enterprise deals. Use when: Structuring B2B sales presentations and demos; Creating pitch decks for complex products; Training sales teams on narrative-driven selling; Converting positioning strategy into sales conversations; Winning against entrenched competitors

Cody-W-Tucker/skills

Swiss-style user-research narrative template in warm-paper editorial aesthetics. Use when users ask for a premium research deck or story-first live artifact with minimalist typography, high-clarity layout, subtle motion, donut breakdowns, and keyboard/click navigation across slides in a single HTML file.

Cody-W-Tucker/skills

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

相关技能