| name | waimao-site | ||
|---|---|---|---|
| description | 创建或改造面向海外采购商的 B2B 外贸网站,使用 Astro + Tailwind,内容来源可选本地文件、RXCMS API 或 WordPress REST API(实验,仅标准文章),覆盖页面规划、B2B 视觉设计、询盘内容和完整的站内技术 SEO(元信息、canonical、sitemap、结构化数据、多语言 hreflang)。新建站默认 static,可按需求选择 server,并支持 Vercel / Cloudflare 部署配置与迁移。用于外贸建站和相关实现,不代替独立的营销运营或通用 CMS 管理。 | ||
| license | MIT; adapted third-party portions retain their licenses (see THIRD_PARTY_NOTICES.md) | ||
| metadata |
|
交付能被采购商理解、能维护内容、具备真实询盘路径的网站。根据现有项目和用户资料实施,不将示例企业当成真实客户。
- 账号注册、安装、GitHub 上传与自动部署需要详细引导时,按主题使用
docs/下的新手文档:开始前准备、安装、开始建站、风格、预览、GitHub、Vercel、Cloudflare、更新、域名、SEO、Cookie、询盘、常见问题、功能一览、使用小技巧、术语速查。用户提问时引导到对应那一篇,不整篇复述。README 只做入口;生成网站仍须提供符合本项目实际配置的说明,不能只引用 skill 文档。 - 默认用户不懂终端、框架、API、环境变量、构建或部署。先用业务语言说明当前阶段和下一步,技术细节留给实施。需要用户操作时再解释术语,例如构建就是把内容生成网站文件,部署就是把网站放到可访问的平台。
- 每轮只询问当前必要的少量信息,通常 1–3 个问题;已有资料先读取。不给用户整张技术配置问卷,不让其决定无关的底层实现。
- 用户操作步骤必须说明:在哪个应用/页面或文件夹操作、输入/选择什么、成功后会看到什么。区分 AI 对话与终端命令;命令依据实际系统给出,路径使用本次真实目录,不让小白原样执行带占位符的命令。
- 网站文件夹按公司英文名命名:这个名字也会成为 GitHub 仓库名,不能用
website、site、my-site这类通用名。新建且用户没有指定位置时,在当前工作文件夹里建一个子文件夹,名字从公司名提炼:优先用客户已有的英文名、域名或品牌名,其次把字号拼音或意译加上主营行业英文,例如“宁波华立泵业有限公司”→huali-pumps、已有域名abc-valves.com→abc-valves;去掉“有限公司”“Co., Ltd.”和城市名(除非城市名就是品牌的一部分)。只用小写英文字母、数字和连字符,2–4 个词、不超过 30 个字符。动手前用一句话告诉用户“网站文件夹和 GitHub 仓库会叫xxx,要改名现在说”,用户没意见就继续,不为此停下等待。不知道公司名时先问公司名(建站本来就需要)。同名文件夹已存在且非空时先识别已有内容再决定,不覆盖。安装 skill 的目录与生成网站目录分开,不在 skill 目录或 assets 模板里制作客户站。 - 生成项目 README 除当前配置外,还须给出小白可跟随的预览、修改、发布和更新步骤;不能只留下命令清单。已有 Node 或依赖就不要求重复安装。
- 本地预览由 AI 代为启动,不让小白敲命令:第一版网站生成完、每轮修改完,以及用户说想看看网站时,AI 不用等用户要求、不要只给命令,直接在网站目录安装依赖(首次)并启动本地预览,确认终端打印出网址后把实际网址发给用户点开,说明这只是本机预览、不是上线网址。预览要在 AI 本轮回复结束后继续运行:优先用工具自带的后台运行;工具会在回复结束时结束子进程的,改为另开一个独立终端窗口运行(Windows 用
Start-Process打开新的 PowerShell 窗口执行npm.cmd run dev,macOS 用osascript让 Terminal 以do script在网站目录执行npm run dev),并告诉用户“看完关掉那个窗口即可”。工具的沙箱拦截安装依赖或启动进程时,向用户申请该次操作的权限,不改成让用户自己敲命令。用户说看完或要结束时,AI 停止预览进程。只有以上方式都不可用时,才用最简单的话告诉用户在哪个文件夹打开终端、输入哪条命令,Windows 下用npm.cmd,并说明为什么没能代为启动。需要用户扫码登录、填密钥或点击平台设置时说明完成标志,不代用户捏造完成结果。 - 明确区分“已生成文件”“本地预览可见”“网站已发布”“询盘已送达”。CMS 连接、自动更新、平台部署和表单尚未实现/验证时如实列出,不用“支持”掩盖剩余工作。
首次新建站时,先用简短说明向用户展示三种选择,不要求用户理解框架术语:
| 对用户的名称 | 内容从哪里来 | 如何更新 |
|---|---|---|
| 纯静态站(默认) | 项目内的本地内容文件,不接 CMS | 修改文件后重新构建发布 |
| RXCMS 站 | rxcms-server API,在 RXCMS 后台管理内容 | 默认取数后构建;后台改动后手动重建或通过已配置钩子触发 |
| WordPress 站 | WordPress REST API,在 WordPress 后台管理内容 | 默认取数后构建;后台改动后手动重建或通过已配置钩子触发 |
- 用户已明确选过或现有项目已有内容来源时,直接沿用并简述,不重复提问;仅当用户要求迁移时更换。
- 新建站未指定内容来源且未要求后台管理时,明确告知采用默认「纯静态站 + 本地内容 + static」,即可开始,不强制等待选择,也不索要 CMS 凭证。
- 用户要求后台管理但未选 CMS 时,询问 RXCMS 或 WordPress;等待期间可做共用页面和设计,不擅自选择平台或把它降级成本地内容。
- 已选 CMS 但缺地址/凭证时,说明环境变量配置方式并继续不依赖接口的工作;不能静默回退成本地示例并声称 CMS 已接通。
- 三种选择区分的是内容来源,全部默认 static。server 是按需单独选择的渲染模式,Vercel / Cloudflare 是独立的发布平台。建站提示和交付说明须分别说清这三项。
- 在生成项目 README 顶部记录实际选择:建站方式、内容来源、渲染模式、发布平台(未决定则标明待选)、询盘处理方式、Cookie 同意配置和内容更新方法。发生切换时同步修改记录与实际实现。
- 新建 Astro 站默认
output: 'static'。内容来源(本地 / RXCMS API / WordPress REST API)、渲染模式(static / server)、部署平台(Vercel / Cloudflare)分别决定。CMS 不自动意味着 server。 - 用户明确选择 server,或确认需要请求时渲染后,才切换模式及适配器。维护已有项目时保留现有模式,除非任务要求迁移。
- 不在建站开始时追问部署平台;上下文已有选择或用户已有 Vercel 账号就沿用。尚未决定时继续生成平台中立的 static 站;到发布阶段默认推荐 Cloudflare(免费版允许商业网站使用),并说明 Vercel 免费版(Hobby)仅限个人非商业用途、公司网站需付费版。切换平台通常只改集中配置;检查平台绑定、运行时 API、环境变量和重定向是否也需要迁移。
- WordPress 作为 API 内容后端,网站前端仍用 Astro;凭证与 RXCMS 一样只放构建/服务端环境变量。默认不生成 WordPress 主题。WordPress 后台仍由已有 PHP / 数据库宿主运行,前端可以部署到 Vercel / Cloudflare。
- 先读取目标项目指令、依赖、页面壳及真实接口。已有页面改动优先复用组件,保留范围外业务行为。SEO 优化不自动授权修改询盘字段和提交流程。
- 除上面的本地预览外,不主动启动其他应用、服务器或后台进程(例如平台模拟器、server 构建的运行时),也不擅自部署或上传。静态检查与针对性测试可以执行。没有实际验证就不宣称表单、线上响应或视觉效果已通过。
- 创建代码不等于授权上传、推送、发布、写入 CMS 或更改域名。用户已明确授权的部署无需重复询问;否则先准备可审阅的配置,再询问发布授权。
每个网站项目根目录有 brief/ 文件夹(starter 已附模板),专门记录这个客户的长期要求,让网站越改越合客户心意:
brief/requirements.md:品牌与风格、内容与文案、产品展示、询盘与联系、禁止事项,以及反馈记录。brief/image-prompts.md:本网站的统一图片风格、避免项、每张图的提示词或图库来源,以及图片反馈。通用规则和提示词骨架在 skill 的 通用生图规范。
做法:
- 每次开始修改网站前先读
brief/,按其中的要求执行;建站时根据客户资料填好初稿。 - 客户提出要求或反馈时,判断是长期的还是只针对这一处。长期的(如“文案要专业严谨”“产品页先放参数表”“图片不要出现人”)写进对应文件和反馈记录,并告诉客户“已记住,以后都按这个来”;一次性的文字修改直接改,不记;图片修正例外,每次都按 通用生图规范 第九节记录。
- 新要求与已记录的冲突时,以客户最新说法为准并更新记录;与“不编造”等底线冲突时说明原因,不照做。
brief/是这个网站自己的资料,必须保留并持续更新,本 skill “提示词在对话中提供”的交付规则不适用于它。用户自己的 AI 工具设置里有“提示词不写入文件”之类规则时,不擅自违背:用大白话问用户一次,例如“要不要把这些图片提示词和你的意见记在网站里?记下来以后改图会越来越准”;用户同意就记,不同意就只在对话里给出。- 维护已有网站时若还没有
brief/,在第一次修改时补建。 - 用户不知道
brief是什么,对用户说“网站里记下的你的要求”“图片提示词记录”,不要求用户说出文件夹或文件名。
怎么保证每次都被读到:不能只靠本 skill 被调用。starter 根目录附带 AGENTS.md(Codex 等支持该文件的 AI 工具会自动读取)和 CLAUDE.md(Claude Code 自动读取,内容为导入 @AGENTS.md 和 @brief/requirements.md),里面写明修改前先读 brief/。网站放在工作文件夹的子目录(如 my-waimao-site/huali-pumps/)时,在工作文件夹根目录也写一份很短的 AGENTS.md 和 CLAUDE.md,只说明网站在哪个子目录、先读其中的 AGENTS.md 与 brief/(CLAUDE.md 可直接导入 @huali-pumps/AGENTS.md 和 @huali-pumps/brief/requirements.md,按实际文件夹名替换)。这些文件只放指引,不复制整份要求;已存在同名文件时在末尾追加一节,不覆盖原内容。
- 识别新建还是维护,按上面的选择规则说明建站方式和默认值。读取已有资料,确定企业类型、目标采购商、产品、市场语言、内容来源和主要转化目标。只询问影响当前决策的缺项;未知认证、交期和产能不能编造。
- 规划页面和内容,读取 planning 和 页面蓝图(各类页面的模块、文案规则、title 写法与结构化数据)。新建或视觉改造时读取 design,围绕产品展示、采购信息和询盘提出适合客户的视觉方向,再落实到页面。使用者无需另外安装设计 skill;简单修复不强制重新做全站策划或设计。
- 读取 astro 实现共用前端;内容来源选 RXCMS 时再读 rxcms,选 WordPress API 时再读 wordpress。只加载相关内容源分支。
- 生成或修改页面、内容和真实询盘路径。新建 Astro 可使用 starter,默认单语言,本地 static 站已支持多语言;RXCMS / WordPress 内容源的多语言需要单独接入。模板不是完成的客户网站;不要覆盖已有项目。
- local 产品和文章使用 Astro 内容集合:
src/content/products/<语言>/*.md、src/content/articles/<语言>/*.md,frontmatter 校验必填字段,共享 key 关联译文;不再使用产品 JSON。缺译文不生成页面,本地文章存在时接通栏目及详情。RXCMS / WordPress 保留原适配流程。 - 本地页面图片放
src/assets/,集合图片用image()引用并填写 alt,页面用astro:assets的 Image / Picture 输出宽高和多尺寸,栅格图优先 WebP。首屏主图 eager + high,其余 lazy。大型 SVG、固定地址的 favicon 和分享图保留 public;远程 CMS 图片保持原处理。不要生成虚构品牌素材。 - 启用 RXCMS 询盘时读取 inquiry。static 可以独立配置询盘函数,不因此切换 server;配置后先生成对应平台入口并提交,再部署。保存、垃圾判定和通知结果分别表达,旧后端通知结果未提供就标未知。客户建站到联调阶段再取得测试站点与收件人,不能要求 skill 使用者在尚未建站时提供这些信息。
- 涉及 Cookie 弹窗、Google 统计或广告时读取 consent。新模板有默认开启但无 Google ID 的同意框;解释用途和开关,沿用用户已有选择。关闭同时停用随包标签,不注入真实站点的跟踪 ID;交付文档写清配置、数据用途和未验证项。
- local 产品和文章使用 Astro 内容集合:
- 涉及路由、索引、内容或 SEO 输出时读取 seo。将发现转为代码修复或有依据的待办,不只输出评分。
- 根据目标平台读取 deployment。在生成项目 README 中写清当前模式、平台、部署操作、环境变量、CMS 更新和平台切换步骤。不能只链接回本 skill。
- 新手优先使用 GitHub 仓库连接平台的自动构建路线,说明保存、Commit、Push、部署的区别;不为了这条现成功能额外搭建 GitHub Actions。Cloudflare 注册与连接 GitHub 分开解释。客户网站仓库与开源 skill 仓库分开。
- 到上传 GitHub 阶段,由 AI 在网站文件夹里初始化 Git 仓库(分支 main),确认
.gitignore排除.env、node_modules、dist等后做第一次提交,只在本机、不推送;然后让用户在 GitHub Desktop 用 Add local repository 选中这个文件夹并 Publish。不让用户用 New repository 自己起名新建,那样容易建出一个没有网站文件的空仓库。用户的平台显示框架为 Other 或访问 404 时,先检查仓库根目录有没有网站的package.json。
- 按 verification 检查本次改动,报告已验证、未验证和需要用户提供的事项。
新建网站时按阶段带用户往前走。每个阶段结束时用业务语言告诉用户:做了什么、需要他确认或补充什么、下一步是什么;用户确认或说“继续”后再进入下一阶段;设计阶段用户没有偏好、也没有影响选择的缺项时,按推荐方案直接继续,不额外要求确认。生成网站后直接启动预览进入阶段 5,不等待确认。用户已给齐资料并要求一次做完时,可连续推进,但仍在最后逐项汇报。
- 了解业务:读取已有资料,补问影响建站的缺项(通常 1–3 个问题):卖什么、卖给谁、哪些国家和语言、怎么接询盘。说明默认方案(纯静态站 + static + 英文),用户另有要求再调整。
- 规划页面:按 planning 和 页面蓝图 列出页面清单、导航和网址,标出每页还缺哪些资料。请用户确认页面清单。
- 定设计方向:按 design 用文字给出推荐方向(颜色、字体、首页内容顺序、图片表现)及理由;用户没有偏好就按推荐继续。用户给出喜欢的参照网站或主题时,按 design 的“风格复刻”只复刻风格、不复制素材。需要图片时按 通用生图规范 生成或挑选,网站独有的图片风格和提示词记在网站项目的
brief/image-prompts.md。 - 生成网站:从 starter 生成项目,按页面蓝图写各页内容和 SEO 元信息;资料缺失处保留结构并汇总待补清单,不编造。
- 用户预览与修改:网站生成完,AI 不等用户要求,直接按上面的方式启动本地预览,把网址和建议查看的页面发给用户,按反馈修改;预览开着时修改会自动刷新。
- 上线前检查:按 verification 的“上线前检查清单”逐项检查,用业务语言报告通过项、待补项和需要用户确认的事。
- 发布与收录:按 deployment 引导发布(默认推荐 Cloudflare);资料真实、正式域名可访问后再开启收录,并引导提交 Google Search Console。
交付目标项目源码、项目自己的使用及部署 README、必要配置和验证结果。提示词直接在对话中提供;不要为了交付创建提示词文件(例外:网站项目 brief/ 下的客户要求和生图提示词记录是网站自身的资料,不受这条限制,按上方“沉淀客户要求”维护)。客户资料与密钥不放进 skill 源码仓库。
上游方法与许可见 THIRD_PARTY_NOTICES。核心不要求 Claude 专用工具、额外 SEO skills、付费 API 或自动多代理编排;有可用工具时再增强。