Communitygithub.com

YuukiMarine/websiteskills

通过对话构建并部署网站——收集需求、生成经过验证的 site.json、使用 Sitesmith 模板渲染,再通过 Nginx 发布。适用于“帮我建个网站”、着陆页、个人/商业网站、作品集等场景。

websiteskills 是什么?

Sitesmith 是一个基于对话的网站构建技能,让 AI 智能体通过自然语言交互,帮助用户从零创建或更新网站。它采用“数据驱动”的方法:智能体收集用户需求后,生成一份严格符合 JSON Schema 的 `site.json` 文件,然后使用预定义的 Sitesmith 模板渲染成静态网站,最后通过 Nginx 部署并启用 HTTPS。该技能支持单页和多页网站(含博客),提供丰富的主题定制选项(内置模板或自定义调色板、字体、圆角、密度),并内置验证、预览和迭代工作流。用户可随时要求修改内容、添加页面或更新样式,所有编辑只需重新生成完整的 `site.json` 并重新渲染即可。该技能适用于 Claude Code、Cursor 等支持终端工具的 AI 智能体平台,通过脚本进行验证、渲染和部署。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

在你喜欢的 AI 中提问

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

文档

Sitesmith — 对话式网站构建器

通过几轮对话即可生成一个完整的、可选双语的网站并发布。你生成的是数据,而非代码:一个单一的 site.json 文件,由固定且设计精美的模板渲染。这使得输出稳定且可轻松换肤。

使用时机

当用户想要创建或更新网站、着陆页、个人或商业网站、作品集时使用,例如:“帮我建个网站”、“我想做个网站”、“更新我的主页”、“为我的面包房做个着陆页”。

快速参考

参考文件——仅当需要时通过 skill_view("sitesmith", "<path>") 加载:

  • references/site.schema.json — 每个 site.json 必须满足的合约
  • references/sections.md — 14 种区块类型(含 posts):使用时机、字段、文案限制
  • references/theme.md — 主题令牌(模板、颜色、字体、圆角、密度)
  • references/assets.md — 图片策略(占位图 / Unsplash;绝不虚构资源)
  • references/examples/innoe.site.json — 完整的单页示例(少样本)
  • references/examples/multipage.site.json — 多页+博客示例(少样本)

脚本——通过终端工具运行:

操作命令
验证node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
渲染node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir>
部署bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain>

流程

  1. 收集需求(3–5 轮对话,分组提问——不要审问)。

    • 业务名称 + 一句话描述他们做什么;行业 + 客户群体。
    • 主要目标(电话/预订/注册/销售/展示)。
    • 语言——默认使用对话语言;提供双语选项(例如 en + zh)。
    • 范围:单页还是多页? 默认单页。如果他们想要更多(或提到博客),提供标准页面集(首页 / 关于 / 服务 / 博客 / 联系)并让他们精简——在构建前确认页面列表。
    • 前 3–5 项服务/产品;他们的独特之处;任何真实数据;联系方式 + 主要行动号召。
    • 用一两个词描述氛围(→ theme);资源(logo?品牌色?真实照片?)。
    • 如果用户很简短或说“做得好看就行”,则使用合理的默认值继续(单页是安全的默认值)。
  2. 起草 site.json 使其符合 references/site.schema.json。首先研究匹配的示例(单页看 innoe.site.json,多页看 multipage.site.json)。为每个页面选择 5–8 个与实际内容匹配的区块(参见 references/sections.md 中目标→区块脊骨映射)。

    • 单页: 所有内容放在顶级 sections 中。
    • 多页: 首页保留在顶级 sections 中;添加 pages[](每个子页面一个条目,各有自己的 sections)。导航自动从页面派生。博客是一个包含 posts 区块的页面(轻量级:标题卡片,无文章页面)。 选择外观(参见 references/theme.md):要么在品牌具有强烈、明显美学时选择样式化模板(newchinese/cyber/portfolio),或者 — 默认方式 — 使用 template:"pro" 并自行设计一套定制调色板(primary/accent/neutral/font/radius/density),根据业务的感觉,使每个站点独一无二。按照 references/assets.md 处理所有图片。
  3. 验证。 运行 validate.mjs。若失败,阅读错误信息,修复 JSON,重新运行。绝不在无效文件上继续。

  4. 渲染。 运行 render.mjs <site.json> <out-dir> → 在 <out-dir>/dist 生成静态网站。如果设置了 UNSPLASH_ACCESS_KEY,渲染会自动将 unsplash 占位符替换为真实照片(带署名);未设置则渲染主题占位图——两者均可发布。

  5. 预览与迭代。 用通俗语言总结你构建的内容(“一个5页双语网站:首页、关于、服务、日志、联系”——或“一个6区块单页”)。告知用户网站始终保持完全可编辑——他们可以随时要求你添加/删除页面或区块、重写文案、更改颜色或添加博客文章。通过重新输出完整的 site.json 来应用编辑,然后重新验证 + 重新渲染。

  6. 部署(仅在用户批准预览后)。运行 deploy.sh <out-dir> <domain> → 通过 Nginx 上线并启用 HTTPS。报告在线 URL。

常见陷阱

  • 输出是数据,不是代码。 只生成 site.json。绝不可手写 HTML/CSS。
  • Schema 就是法律。 字段名和枚举值必须完全匹配;省略未知字段。
  • 不虚构资源。 使用 Media type:"placeholder"(装饰性)或 "unsplash" 并带 query(内容照片);仅当用户提供了真实 URL 时才使用 "image"。Logo 默认使用 type:"text",除非存在真实的 logo 文件。
  • 功能/服务优先使用图标而非图片——Lucide 名称始终可渲染并可重新着色。
  • 每个 LocalizedText 包含网站所有语言。 地道地翻译;绝不留空。
  • 不要过度构建。 5–8 个区块。交替区块背景色;绝不可连续两个 dark 或 primary。始终以 hero 开头,以 cta 或 contact 结尾。
  • 不包含合规风险声明——不得虚构用户未提及的认证、背书、政府补贴/资助、奖项或统计数据。
  • 单页是默认值。 仅当用户想要更丰富/多页网站或博客时才添加 pages[]——并先与他们确认页面列表。博客(posts)是一个标题列表,而非完整文章;需说明这点,并告知文章可以后续添加。

验证

  • validate.mjs 退出码为 0(它会打印解析后的区块顺序)。
  • render.mjs 生成 <out-dir>/dist/index.html。
  • 部署后,curl -I https://<domain> 返回 200。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能