← 开发笔记

用 Claude Code 和 Codex 制作网站:从规划到部署的技能

本文目录

如果要搭建小型企业网站,可以先整理文案和页面结构,实现界面,再用浏览器验证访客能否找到咨询入口。有登录或支付的 Web 应用,则要先设计权限、数据存储和故障恢复。明确网站类型后,就能具体确定需要哪些技能,以及如何判断结果。

本文按阶段选出候选技能,依据是 2026年11月19日查阅的 Anthropic、OpenAI 和 Vercel 官方技能源文件。示例以在 Claude Code 和 Codex CLI 中把任务交给代理为背景。 Anthropic 技能合集 · OpenAI Build Web Apps · Vercel Agent Skills

按网站类型选择技能

制作对象 优先确定的内容 基本组合
展示网站、作品集、博客 访客、关键操作、公开页面、内容更新方式 页面文案 → 界面实现 → 浏览器测试 → 部署检查
预订、支付、后台管理 Web 应用 不同用户的权限、要保存的数据、成功及失败处理、运行记录 界面与状态设计 → 界面和服务器实现 → 测试正常与失败流程 → 预览 → 生产环境检查

如果已有代码仓库,先确认项目使用的框架和部署方法。例如,要在 Astro 博客中添加文章和咨询链接,可以沿用现有架构。确实用到相关技术或功能时,再选择 React、Next.js 性能技能或支付技能。

阶段 推荐技能或依据 委托工作与验证方式
规划与文案 项目内的 website-copywriting 指南 确定目标访客和关键操作,撰写标题、说明和咨询文案。阅读首屏,确认信息是否说清服务对象及服务内容。
界面设计 项目内的 frontend-architecture-design 指南 确定页面路径、组件和状态的归属、成功和错误界面。在预订应用中,设计如何处理提交期间的重复点击,以及保存失败后的重试。
界面实现 Claude Code 的 frontend-design 或 Codex 的 frontend-app-builder 用现有项目组件实现获批的文案和页面结构。确认页面变窄时,标题、操作按钮和正文仍能依次阅读。
浏览器验证 Claude Code 的 webapp-testing、Codex 的 frontend-testing-debugging 在移动视口检查咨询链接、表单错误和控制台。记录检查使用的 URL、视口尺寸、实际复现步骤和结果。
无障碍审查 Vercel 的 web-design-guidelines 从代码中检查标签、对比度及焦点,再在浏览器里检查键盘操作顺序和焦点显示。记录自动检查结果和人工检查。
React 性能 Build Web Apps 的 react-best-practices 检查 React、Next.js 项目中的串行数据请求和初始打包体积。在同一环境测量修改前后,再判断改进效果。
部署 Vercel 的 deployments-cicd 或项目部署指南 先在相应托管平台确认预览或预发布 URL,再部署获批版本。记录最终 URL 和可回滚的版本。

表中的前两项是可以在项目内定义的角色示例。使用公开技能时,请按维护团队提供的路径安装。在 Claude Code 中,Anthropic 官方市场的 example-skills 包括界面实现与测试技能。在 Codex 中,Build Web Apps 插件包含界面实现、测试和 React 优化技能。托管在 Vercel 时使用 Vercel 部署技能,使用 GitHub Pages 时则遵循仓库的 Actions 和预览流程。 Claude Code 安装指南 · OpenAI Build Web Apps 插件内容

小型网站如何衔接不同技能

制作请求不必很长。像下面这样提供服务信息、页面结构和需要验证的操作,就能在规划、实现和测试阶段采用同一套标准。

提示示例 为一家虚构的摄影工作室制作展示页面。 访客想了解拍摄地点和咨询方式。 在同一页面布置简介和咨询说明,将首屏的“咨询”链接 连到页面内的咨询说明。按简介、咨询链接、咨询说明的顺序排列。 考虑 360px 窄屏和键盘操作。 实现后,检查 360px 和 1280px 下是否有横向溢出, 用 Tab 移到咨询链接,再按 Enter 打开咨询说明。 记录每一步的结果和未能验证的项目。

把简介和咨询链接交给界面实现阶段,将视口大小和键盘条件用作测试判定标准。如果测试失败,把失败时的视口宽度和操作交给负责实现的代理。修复后用相同条件重新运行。无障碍审查还可检查对比度、屏幕阅读器读出的名称,以及进入其他页面后的焦点位置。

练习:用 Playwright 检查咨询流程

将网站的一页放入测试文件,在浏览器中用两种视口宽度检查。在新目录准备 Node.js 22 和 Chrome。运行 npm init -y,再用 npm install --save-dev playwright-core@1.64.1 安装依赖。将以下代码保存为 website-check.mjs,在 macOS 上运行 node website-check.mjs。Chrome 安装位置不同时,把可执行文件路径设到 CHROME_PATH。 Playwright 浏览器启动选项

在两种屏幕尺寸下打开介绍页面,检查是否横向溢出,再按 Tab 移到咨询链接,按 Enter 验证能否到达咨询部分。如果失败,修正后用相同条件重跑。

import assert from 'node:assert/strict';
import { chromium } from 'playwright-core';

const html = `<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>봄 사진 스튜디오</title>
<style>
  body { margin: 0; font: 1rem/1.6 system-ui; }
  main { max-width: 42rem; margin: auto; padding: 1rem; }
  section { min-height: 74vh; }
</style>
<main>
  <section>
    <h1>봄 사진 스튜디오</h1>
    <p>프로필 사진과 가족사진을 촬영합니다.</p>
    <a href="#contact">문의하기</a>
  </section>
  <section id="contact">
    <h2>상담 안내</h2>
    <p>촬영 목적과 희망 일정을 준비해 주세요.</p>
  </section>
</main>
</html>`;

const browser = await chromium.launch({
  executablePath: process.env.CHROME_PATH
    ?? '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
});

try {
  for (const width of [360, 1280]) {
    const page = await browser.newPage({ viewport: { width, height: 700 } });
    try {
      await page.setContent(html);
      const overflow = await page.evaluate(
        () => document.documentElement.scrollWidth > window.innerWidth,
      );
      assert.equal(overflow, false, `가로 넘침: ${width}px`);

      await page.keyboard.press('Tab');
      const focused = await page.evaluate(
        () => document.activeElement?.getAttribute('href'),
      );
      assert.equal(focused, '#contact', `문의 링크 포커스: ${width}px`);
      await page.keyboard.press('Enter');
      await page.waitForURL(/#contact$/);
      const heading = await page.getByRole('heading', { name: '상담 안내' }).boundingBox();
      assert.ok(heading && heading.y >= 0 && heading.y + heading.height <= 700);
      console.log(`PASS ${width}px: no overflow, keyboard link reaches contact`);
    } finally {
      await page.close();
    }
  }
} finally {
  await browser.close();
}

下面是运行结果。每项 PASS 都表示页面没有横向溢出,且用键盘移到咨询链接并激活后,咨询说明的标题出现在视口中。

PASS 360px: no overflow, keyboard link reaches contact
PASS 1280px: no overflow, keyboard link reaches contact

在实际项目里,启动本地服务器,用 page.goto() 打开实现后的页面,替代测试用的 HTML 字符串。对于咨询表单,要单独加入缺少必填字段、提交失败后保留输入、以及成功消息的检查。将咨询链接改为指向另一个 URL 片段时,360px 下的链接检查失败。上面的示例在 Chrome 中用两个视口宽度检查了一个练习用 HTML 页面。

部署后要检查的项目

在预览和生产 URL 重新打开主要页面,走一遍咨询流程,确认服务器响应和静态资源正常。准备公开给搜索引擎的页面还要检查文档标题与描述、规范网址、内部链接和站点地图。生产 URL 能打开后,还要另用 Search Console 确认搜索引擎是否实际发现并编入索引。 Google SEO 入门指南

讨论