Communitygithub.com

客户网站搭建

跑通客户网站的整条流水:需求与设计采集、站点地图和文案、搭建、检查、审阅、SEO 和上线准备,中间有两道确认,修改次数有上限。

客户网站搭建 是什么?

从采集做到上线准备,用来新开或重建一个客户站点,并在确认点停下,而不是无休止地改视觉。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgfeletar/website-builder/tree/HEAD/core/.claude/skills/build-site

在你喜欢的 AI 中提问

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

文档

构建一个客户网站

主会话运行此流水线,并将任务委托给子代理。(子代理无法启动其他子代理,这就是为什么这是技能,而非编排代理。)

[0 输入关卡]  需求简报 + DESIGN.md + 参考资料
      ↓
[1 规划]  站点地图、页面分区、文案  →  plan.md, src/data/*
      ↓
[用户关卡 1]  审批规划与文案
      ↓
[2 构建]  页面与视觉系统
      ↓
[3 SEO]     SEO 代理            →  seo-report.md
      ↓
[4 验证]  npm run verify(硬关卡)
      ↓
[5 审查]  站点审查代理  →  review-report.md
      ↓
[6 修复循环]  P0/P1 → 修复 → 验证 → 重新审查(最多 2 轮)
      ↓
[用户关卡 2]  审批站点
      ↓
[7 上线准备]  上线检查清单 + 交接文档
      ↓
[8 经验总结]  追加到 docs/lessons.md

制品

所有内容放在 .claude/pipeline/ 下:

pipeline-state.md   阶段、修复轮次、最后更新
plan.md             站点地图、每个页面的分区、每个页面的主要操作
review-report.md    来自站点审查代理
seo-report.md       来自 SEO 代理
screenshots/        来自 npm run verify

在每个阶段开始时读取 pipeline-state.md,从其所指位置继续。在每个阶段结束时更新它。这样构建可以跨越多个会话。

阶段 0:输入关卡

逐项检查。如果任何项缺失,停止并帮助用户在进入其他阶段之前补充完整。

项目准备就绪条件
.agents/product-marketing.md业务信息部分完成,主要操作已命名,受众和语气已填写。使用 product-marketing 技能根据用户提供的内容草拟它。
src/data/business.json名称、电话、地址、营业时间、地图链接与需求简报一致。从需求简报中复制它们。
DESIGN.md每个部分都已填写。如果用户只有参考资料,则从 references/ 草拟它,并要求用户确认。
references/至少两个截图或 URL,并说明从每个中借鉴什么。
客户资产Logo 和照片,或明确说明可以使用占位符。
编辑权限客户是否会自行编辑网站?(影响阶段 7。)

然后根据 DESIGN.md 填充 src/styles/tokens.css。

阶段 1:规划

  1. 编写 plan.md:页面(大多数客户需要首页、每个主要服务的页面或菜单/服务页面、关于、联系),每个页面的一个主要操作,以及每个页面上的分区顺序。使用需求简报和 site-essentials。
  2. 使用 copywriting 技能编写文案,然后对其运行 copy-editing。从需求简报的客户语言和客户自己的用词开始,并几乎原封不动地使用其中一些短语。遵循 CLAUDE.md 中的内部规则 9(不使用通用的 AI 措辞)。将文案放在 src/data/ 下(home.json, services, FAQs),而不是放在组件中。
  3. 将任何你不知道的内容标记为 [NEED: ...]。永远不要用虚构的事实填补空白。

用户关卡 1

停止。向用户展示:站点地图、每个页面的分区和主要操作、完整文案以及每个 [NEED: ...] 项目。等待批准或修改。现在修改文案比构建之后更便宜。

阶段 2:构建

使用 design-taste-frontend 技能(品味技能)在此 Astro 项目内构建。开始之前,告诉它:

  • 类型是 place(人们前往)或 service(人们被雇佣),绝不能是技术类型。
  • DESIGN.md 和 references/ 设置调色板、字体和风格。它自带的调色板和字体被覆盖。
  • 业务信息来自 src/data/business.json。它的占位联系人规则不适用。
  • 动效遵循 CLAUDE.md 中的内部规则。

逐页构建,先构建首页。构建首页后,运行 npm run verify,查看三个截图,并在构建下一页之前修复你所看到的问题。品味技能的完成关卡在它停止时自行运行;将其发现作为输入,但 CLAUDE.md 在冲突时优先。

阶段 3:SEO

SEO 代理编辑 head 标签、JSON-LD 和 robots,因此它在验证和审查之前运行。这样审查将评判最终完成的站点。

seo: "审查并为该站点实现 SEO,包括本地企业步骤。需求简报:.agents/product-marketing.md。将你的报告写入 .claude/pipeline/seo-report.md。"

阶段 4:验证(硬关卡)

npm run verify

所有 check-site 失败项和截图问题(横向滚动、控制台错误)必须在审查之前修复。[NEED: ...] 失败项仅允许用于用户已经被询问过的事实;列出它们。重写任何 check-site 标记为通用的文案,除非客户实际使用了该词语。

阶段 5:审查

审查代理是只读的,并以最终消息的形式返回报告。将该消息原样保存到 .claude/pipeline/review-report.md。

site-reviewer: "审查构建完成的站点。规划:.claude/pipeline/plan.md。需求简报:.agents/product-marketing.md。设计:DESIGN.md。截图:.claude/pipeline/screenshots/。已完成的 SEO 更改:.claude/pipeline/seo-report.md。将完整报告作为你的最终消息返回。"

阶段 6:修复循环

site-reviewer 裁决操作
准备就绪前往关卡 2
需要跟进,仅 P2前往关卡 2,列出 P2
需要跟进(P1)或阻塞(P0)轮次 < 2:修复它们,重新运行阶段 4(验证),对更改过的页面重新运行 site-reviewer 并保存其报告。轮次 = 2:停止并向用户展示。

对于任何损坏而非仅仅偏离需求的问题,使用 bug-fixer 代理。每次在 pipeline-state.md 中增加轮次计数。

用户关卡 2

停止。向用户展示:在 390 和 1440 宽度下的首页截图、裁决、剩余的 P2、需要做的 SEO 决策、剩余的 [NEED: ...] 项目以及需要替换的占位照片。等待批准。

阶段 7:上线准备

  1. 运行 npm run check:launch 并修复每个失败项。然后填写 docs/launch-checklist.md,将每个项目标记为已完成、不适用或等待某人(说明是谁)。
  2. 为客户填写 docs/handoff.md。
  3. 如果客户将编辑站点,遵循 docs/client-editing.md。
  4. 站点在其真实域名上线后,提醒用户对其运行 claude-seo:/seo local <url> 和 /seo audit <url>。

阶段 8:经验总结

扫描报告和修复轮次,找出任何重复出现问题或花费了大量时间的事情。将每条经验以带日期的行追加到 docs/lessons.md。告诉用户哪些经验值得复制回 site-starter,以便每个未来的站点都受益。

相关技能