构建一个客户网站
主会话运行此流水线,并将任务委托给子代理。(子代理无法启动其他子代理,这就是为什么这是技能,而非编排代理。)
[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:规划
- 编写
plan.md:页面(大多数客户需要首页、每个主要服务的页面或菜单/服务页面、关于、联系),每个页面的一个主要操作,以及每个页面上的分区顺序。使用需求简报和site-essentials。 - 使用
copywriting技能编写文案,然后对其运行copy-editing。从需求简报的客户语言和客户自己的用词开始,并几乎原封不动地使用其中一些短语。遵循 CLAUDE.md 中的内部规则 9(不使用通用的 AI 措辞)。将文案放在src/data/下(home.json, services, FAQs),而不是放在组件中。 - 将任何你不知道的内容标记为
[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:上线准备
- 运行
npm run check:launch并修复每个失败项。然后填写docs/launch-checklist.md,将每个项目标记为已完成、不适用或等待某人(说明是谁)。 - 为客户填写
docs/handoff.md。 - 如果客户将编辑站点,遵循
docs/client-editing.md。 - 站点在其真实域名上线后,提醒用户对其运行 claude-seo:
/seo local <url>和/seo audit <url>。
阶段 8:经验总结
扫描报告和修复轮次,找出任何重复出现问题或花费了大量时间的事情。将每条经验以带日期的行追加到 docs/lessons.md。告诉用户哪些经验值得复制回 site-starter,以便每个未来的站点都受益。