html-anything 的 poster-hero 营销海报技能模板:从 SKILL.md 提示词到 1080×1920 朋友圈分享图的完整实现
html-anything 的 poster-hero 营销海报技能模板:从 SKILL.md 提示词到 1080×1920 朋友圈分享图的完整实现
本文以开源仓库 html-anything(agentic HTML editor)内置的 poster-hero 技能模板为研究对象,从 SKILL.md 源文件 出发,逐层拆解它的 frontmatter 元数据、8 条设计要点、配套的 example.html 完整实现,以及它如何被磁盘技能注册表(loader)、API 路由和转换流程(convert)消费。读完本文,你将掌握"一个技能模板在 html-anything 中是如何被定义、加载、预览并最终驱动本地 AI agent 生成竖版海报 HTML"的完整链路,也能直接复用这套 1080×1920 竖版海报的写法。
一、poster-hero 在技能体系中的定位
html-anything 的模板体系采用"一个技能一个文件夹"的磁盘布局:每个模板目录下包含 SKILL.md(frontmatter 元数据 + 提示词正文)、可选的 example.md(示例输入内容)与 example.html(预渲染预览)。poster-hero 正是其中面向营销场景的竖版海报模板,位于 next/src/lib/templates/skills/poster-hero/,目录下同时具备三个文件,是体系最完整的模板之一。
从 frontmatter 的定义看,它的定位十分明确:
| 字段 | 值 | 含义 |
|---|---|---|
name |
poster-hero |
技能唯一 id,也是磁盘目录名 |
zh_name |
营销海报 |
选择器(picker)中显示的中文名 |
en_name |
Marketing Poster |
英文名 |
description |
竖版海报 / 朋友圈分享图, 强视觉冲击 |
用途描述,直接决定 agent 与用户对其能力的理解 |
category |
poster |
归类的视觉形态 |
scenario |
marketing |
场景键,参与前端筛选分类 |
aspect_hint |
1080×1920 竖版 |
输出画幅提示 |
example_id / example_name / example_format / example_tagline / example_desc |
见下 | 配套示例的元数据 |
其中 example_format: markdown 表示示例输入(example.md)以 Markdown 组织;example_tagline 与 example_desc 分别用一句"9:16 朋友圈分享图"和"高对比度发布海报, 含 QR 码占位 + 渐变 mesh + 噪点纹理"概括了示例的效果特征,方便 picker 直接展示。
scenario: marketing 对应了 scenarios.ts 中定义的营销场景键。该文件维护了 12 个规范化场景键(marketing / engineering / operations / product / design / finance / sales / hr / personal / education / creator / video),未知键的技能依然能加载,只是会被排入末尾的 "other" 桶并以原始 id 显示。
二、SKILL.md 是如何被解析与加载的
SKILL.md 不是被项目硬编码读取的,而是由磁盘技能注册表统一加载。loader.ts 中 parseFrontmatter 实现了一个零依赖的 frontmatter 解析器:它用正则 ^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?([\s\S]*)$ 切出元数据块与正文,逐行按 key: value 形式解析,支持带引号字符串、整数(featured / recommended)与单行数组(tags: ["a", "b"])。
fmToMeta 会将 frontmatter 映射为前端可用的 SkillMeta:zhName、enName、emoji、description、category、scenario、aspectHint、tags,并在 example_id 存在或磁盘上存在 example.md / example.html 时构造 example 元数据。poster-hero 的示例字段齐备,因此会生成一个完整的 SkillExampleMeta,其中 hasHtml: true、hasMd: true。
正文部分(即 --- 之后的内容)则被保存为 LoadedSkill.body——它才是真正喂给 AI agent 的提示词模板。需要特别注意的是:loader.ts 明确注释指出,元数据列表接口会剔除正文(body),以免把提示词全文下发到浏览器;只有调用 loadSkill(id) 加载单个技能时才会拿到 body、exampleMd 与 exampleHtml。
三、8 条模板要点的逐条拆解
poster-hero 的正文是一段结构化的中文设计指令(SKILL.md),共 8 条要点。它们共同约束了 agent 生成的 HTML 结构,逐条展开如下:
- 画布约束:容器必须为
w-[1080px] h-[1920px] mx-auto,配合"全屏渐变 / mesh 背景"。这保证输出固定为 1080×1920 的 9:16 竖版画布,且水平居中,天然适配朋友圈分享场景。 - 上部留白 + 视觉锚点:顶部约 30% 区域留白,放一个大号 emoji 或抽象几何图形,制造呼吸感与品牌记忆点。
- 中部主标题区:主标题占据视觉中心,字号要求
text-8xl且font-black(极大、极粗),配合一句副标题。这是海报的信息主轴。 - 下部信息卡片:3~5 条核心要点,用"图标 + 短句"的卡片形式呈现,把卖点结构化。
- 底部品牌区:右下角放置品牌标识 / 二维码,用 SVG 占位——避免 agent 自行绘制真实二维码。
- 色彩策略:要求大胆配色,渐变背景建议使用
from-violet-500 via-fuchsia-500 to-indigo-500一类的高饱和渐变;文字用白色,另选 1 个对比色做高亮,保证视觉冲击与可读性兼顾。 - 装饰性 SVG:用圆 / 三角 / 波浪 / 噪点纹理等 SVG 元素做装饰,丰富画面层次。
这 8 条是"提示词规范",而它的实际落地效果可以对照配套的 example.html 逐行验证(见下一节)。提示词与示例互为印证的关系,正是 html-anything 模板体系的核心设计:SKILL.md 给 agent 明确的"应然",example.html 则给出"实然"的参考基线。
四、example.html:一份可直接运行的 1080×1920 海报实现
example.html 是 poster-hero 的完整参考实现,也是浏览器 picker 中展示的预览本体。它完全遵循了上述 8 条要点,实现细节如下:
头部依赖:通过 CDN 引入 Tailwind(https://cdn.tailwindcss.com)与三套字体——Inter Tight(标题衬线感无衬线体)、Noto Sans SC(中文)、JetBrains Mono(二维码区命令行代码),并用 display=swap 保证加载体验。
画布与背景(要点 1、6):
<div class="poster" style="position:relative; width:1080px; max-width:96vw; aspect-ratio:9/16; ...">
画布宽 1080px、aspect-ratio:9/16,外层 body 用 display:grid; place-items:center 居中。背景采用三层叠加实现"渐变 mesh"效果:
background:
radial-gradient(ellipse at 80% 0%, rgba(233,185,74,0.55), transparent 55%),
radial-gradient(ellipse at 20% 100%, rgba(108,58,166,0.5), transparent 55%),
linear-gradient(135deg,#c96442 0%,#15140f 60%,#1a0e2b 100%);
两个错位椭圆光晕叠加在 135° 深色线性渐变之上,形成类似 mesh gradient 的光斑层次——这正对应模板要点中"全屏渐变 / mesh 背景"的完整实现。
噪点纹理(要点 7):
.grain { background-image:radial-gradient(rgba(255,255,255,0.4) 1px, transparent 1px); background-size:3px 3px; opacity:0.18; }
一个 position:absolute; inset:0 的白色细点阵叠加层,以 3px 网格铺满全屏、透明度 0.18,模拟胶片颗粒感。
顶部留白与几何锚点(要点 2):顶部一行包含左侧 RELEASE · 2026.05 的英文小标签(letter-spacing:0.28em 的宽字距大写样式)与右侧 120×120px 的玻璃拟态方块 .glyph——圆角 32px、半透明白底、backdrop-filter:blur(12px) 毛玻璃,中间放一个衬线斜体大字母 "H"。这正是"抽象几何图形 + 30% 留白"的落地。
中部主标题(要点 3):
h1 { font-weight:900; font-size:148px; line-height:0.95; letter-spacing:-0.04em; }
148px 的字号配合 0.95 行高与 -0.04em 负字距,远超 text-8xl(96px)的量级;HTML 与斜体金色 Anything(font-family:Georgia...; color:#e9b94a)构成主副视觉层次,下方的 30px 副标题进一步解释产品价值——"任何文档 → 世界级好看的 HTML, 用你本地的 AI agent"。
下部信息卡片(要点 4):4 条特性以纵向卡片列出,每条由 42×42px 的圆角图标方块(半透明白底 + emoji)+ 22px 粗体标题 + 15px 半透明描述组成,间距 18px:
🎨 9 套世界级模板 —— PPT · 简历 · 海报 · 小红书 · 数据报告 …
🔌 8 个本地 agent 自动检测 —— Claude / Cursor / Codex / Gemini / Copilot …
🗝️ 0 API Key —— 复用你已经登录的 CLI session, 0 边际成本
📋 一键发布 —— 公众号 / 推特 / 知乎 / PNG, 直接粘贴
底部品牌区(要点 5):底部用 border-top:1px solid rgba(255,255,255,0.18) 分隔线隔出品牌区,左侧是 120×120px 的白色圆角二维码占位。二维码并非真实可扫,而是用纯 SVG 手绘的 QR 码图案——三个定位角(回字形)加随机散布的 2px 数据块,完美呼应模板要点"用 SVG 占位"的约定。右侧用 JetBrains Mono 等宽字体展示命令行 $ pnpm dlx html-anything,把"产品名称 + 安装命令"做成海报的收尾信息。
五、示例输入:example.md 与提示词的对应
example.md 是 agent 的示例输入内容,模拟一份真实的"产品发布"素材:
# HTML Anything 0.1 已发布
## 一句话
任何文档 → 世界级好看的 HTML, 用你本地的 AI agent
## 特性
- 9 套世界级模板
- 8 个本地 agent 自动检测
- 0 API Key, 复用本地登录 session
- 一键复制到公众号 / 推特 / 知乎
## CTA
github.com/nexu-io/html-anything · 一行命令跑起来
可以清楚地看到它被 example.html 一一吸收:H1 变成海报主标题,一句话变成副标题,4 条特性变成 4 张图标卡片,CTA 变成底部品牌区。这正是 html-anything 的核心工作流——"Markdown 素材 → 技能提示词 → 结构化的精美 HTML"——的最小闭环示范。
六、运行时调用链:SKILL.md 如何驱动 AI agent 生成海报
当用户在前端选择 poster-hero 模板并提交内容后,请求会走到 next/src/app/api/convert/route.ts 的 POST /api/convert。关键逻辑如下:
- 请求体携带
agent(本地 agent 类型)、templateId(如poster-hero)、content(用户素材); - 调用
loadSkill(templateId)从磁盘加载技能,命中SKILL.md得到body(8 条设计要点)与元数据; - 通过
assemblePrompt({ body: skill.body, content, format })把模板提示词与用户内容拼接为完整的 agent 指令; - 调用
invokeAgent以 SSE 流式输出 HTML,前端实时渲染预览。
这里还支持"最小化差异编辑"模式:如果前端同时回传 editFromHtml 与 editFromContent,则走 buildEditPrompt,要求 agent"仅按内容差异修改、保留原有设计",避免每次修改都推翻重画——这在海报文案迭代场景中非常实用。
前端侧的消费路径同样清晰:/api/templates 返回全部技能的元数据列表(Cache-Control: public, max-age=5,既去重又保证新增技能快速可见);example 路由 一次性返回 example.md + example.html 的 JSON 包,供用户点击"预览"时直接灌入编辑器;preview 路由 则把 example.html 原样以 text/html 返回,让模板画廊用 <iframe src=…> 加载缩略图——避免把几十个预览 HTML 塞进 srcDoc 阻塞主线程。客户端则由 shared.ts 中的 useTemplates() 统一拉取并缓存,refreshTemplates() 在安装 / 卸载技能后即时刷新列表。
七、如何基于此模板扩展与复用
从源码结构可以推断出新增一个同类海报技能的通用路径:只需在 next/src/lib/templates/skills/ 下新建一个文件夹,放入 SKILL.md(frontmatter + 正文要点),再按需提供 example.md 与 example.html,无需改动任何 TypeScript 代码——loader 会重新扫描磁盘,API 会自动暴露新技能,前端刷新后即出现在选择器中。poster-hero 的 frontmatter 中 featured / recommended 字段(loader.ts 已解析)还可让技能进入 picker 顶部的"推荐"分组并控制排序。
对于需要把 poster-hero 的写法迁移到其他竖版场景(如小红书卡片、电商 Banner、活动主视觉)的开发者,可以直接复用这套经过验证的骨架:9:16 画布 + 多层渐变 / mesh 背景 + 噪点叠加层 + 玻璃拟态视觉锚点 + 大字号负字距标题 + 图标信息卡 + SVG 二维码占位。唯一需要留意的限制是,示例中的字体与 CDN 依赖必须保持网络可达,且产物面向静态 HTML 场景,动态数据应交给 agent 在生成阶段按素材写入。