全部技能 / 设计 / prototype-web
设计 · nexu-io/html-anything

prototype-web

可点击的功能性 Web 原型, 含导航、英雄区、特性区、CTA

风险提醒:绿色 · 放心使用AI 侦查报告
作者 nexu-ioGitHub nexu-io/html-anything ↗Stars 8827许可 Apache-2.0(仓库根 LICENSE 首两行为 "Apache License" 与 "Version 2.0, January 2004";pool.json 记 license=Apache-2.0)commit 553ed98c28
agent 宿主通常会约束 skill 执行权限;风险提醒为 AI 侦查观点,不构成质量或安全保证。第三方 skill 仅作拆解与展示,安装使用风险自负,版权归原作者。

1实现原理 · 为什么它能做到

本 skill 不是可执行程序,而是一段纯文本提示词模板:宿主用正则解析 SKILL.md 的 YAML frontmatter,把正文 body 作为提示词主体加载。

next/src/lib/templates/loader.ts
const { fm, body } = parseFrontmatter(raw);
注:仓库对目录约定的自述:‘SKILL.md — frontmatter (id, scenario, tags, …) + prompt body’,以及 ‘Adding a template = adding a folder. No TS code change required’——模板靠目录约定注册;全仓 TS/TSX 中检索不到 "prototype-web" 的硬编码引用,本模板没有被任何代码特判。

模板正文不会单独执行,而是被拼进最终 prompt 的"模板段":共享设计指令 + 本模板正文 + 用户内容。

next/src/app/api/convert/route.ts
prompt = assemblePrompt({ body: skill.body, content, format });
注:shared.ts 的 assemblePrompt 自述:‘Wrap a per-template instruction body with the shared design directives and the user content tail.’;请求先经 const skill = loadSkill(templateId); 取到本目录的 body,再拼装。

全局"内容驱动数量"规则覆盖模板里的任何数字:模板只定义版面/风格/配色/组件库,不定义输出长度。

next/src/lib/templates/shared.ts
数量**完全由【用户内容】的实际长度和信息结构决定**
注:该规则被标为"最高优先级, 覆盖模板里的任何数字",并明写 deck 类模板里"6-10 张"这类数字"一律视为短示例下的参考下限"。因此本模板给的是可用版面与约束,不是页数上限。

产物形态被全局硬约束:单文件 HTML、纯 HTML 无围栏、第一个字符必须是 <、且不得写文件(由前端捕获 stdout)。

next/src/lib/templates/shared.ts
不要用 markdown 代码围栏包裹, 不要任何解释性文字
注:同一段还写明 ‘禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具’——文件落盘由宿主前端负责,模板侧不产生写盘行为。

frontmatter 的元数据驱动选择器呈现(中文名/英文名/emoji/描述/分类/场景/画幅/标签/示例元数据)。

next/src/lib/templates/loader.ts
zhName: fm.zh_name ?? fm.name ?? id,
注:本模板元数据:category=prototype、scenario=design、aspect_hint=1440×900 桌面(无 featured,选择器里排到推荐桶之后)。选择器按 category/scenario 分组、按 featured 排序,全部由 frontmatter 决定,无代码特判。

随包示例资产经两条只读 API 暴露给前端:example.html 原样返回进 iframe,example.md 作为"预览"按钮的输入内容。

next/src/app/api/templates/[id]/preview/route.ts
verbatim so it can be loaded into an
注:example.html 的响应头是 Content-Type: text/html; charset=utf-8;另一路由以 content: skill.exampleMd ?? "", 把示例文本交给客户端。本目录:有 example.md(651 字节)与 example.html(13472 字节)。

生效链(宿主行为,非本模板代码):宿主 spawn 本机已登录的 agent CLI,把拼好的 prompt 经 stdin 送入,从 stdout 流式回收 HTML。

next/src/lib/agents/invoke.ts
child.stdin.write(opts.prompt);
注:子进程以 cwd=process.cwd()(cwd: opts.cwd ?? process.cwd(),)运行、stdio 全 pipe;prompt 走 stdin/--message 而非 shell 拼接(not interpolated into a shell command)。

模板给的是"页面分节清单 + 每节要点",模型按节填充;Pricing 标为可选,说明模板允许按业务裁剪区块。

next/src/lib/templates/skills/prototype-web/SKILL.md
- Sections: Top Nav (logo + 导航 + CTA 按钮)
注:与 pricing-page 互补:本模板是整站骨架(Pricing 一节点到为止),pricing-page 是定价页深钻。

响应式与交互都给了实现路径(md: 断点、pure CSS 入场动画、details 手风琴),把"看起来像原型"的两大要素——自适应与反馈——写进规格。

next/src/lib/templates/skills/prototype-web/SKILL.md
移动端单栏, 桌面多栏
注:交互项里 nav 滚动变色需要少量 JS(随产物自包含),其余(hover、details)是 CSS/原生控件。

"高保真/明天就能上线"是这 9 份里对成品度要求最直白的表述,配合共享指令的"必须用用户提供的真实数据"共同压制占位式输出。

next/src/lib/templates/skills/prototype-web/SKILL.md
- 这是高保真原型, 应该让人觉得"明天就能上线"。
注:example.md(651 字节)用虚构产品 Inkstack 给出全套素材(定位/特性/评价/价格/CTA),可当作"输入长什么样"的范例。

2核心能力

01输出完整 landing page(而非片段)
02固定的分节骨架:Top Nav → Hero → Features → How → Social proof → Pricing(可选) → Footer
03现代 SaaS 视觉趋势(大字号/柔和渐变/glassmorphism/入场动画,纯 CSS)
04响应式断点要求(移动单栏 / 桌面多栏,至少 md:)
05交互细节:nav 滚动变色、特性卡 hover 浮起、FAQ 手风琴
06成品度要求:"让人觉得明天就能上线"

3外部依赖

类型依赖
networkTailwind Play CDN(共享指令对产物的要求)
networkjsdelivr CDN(可选:图表/动画脚本)
networkGoogle Fonts(共享指令指定)
cli本机 coding-agent CLI(宿主检测 PATH 并 spawn)
network随包示例 example.html 的外链(产物示例)

4风险提醒 风险提醒:绿色 · 放心使用

风险提醒:绿色 · 放心使用
  • 用户内容逐字拼进 prompt,无隔离标记 → 指令注入面 — assemblePrompt 把用户内容直接接在 ‘【用户内容】:’ 之后,模板正文在前、用户内容在后且无分隔;宿主侧 agent 以高权限运行(claude 为 --permission-mode bypassPermissions),注入若生效即为高权限落地。
  • 宿主环境变量全量透传给被 spawn 的 CLI — argv.ts envFor 以 ‘const base = { ...process.env };’ 构造子进程环境:shell 里存在的一切变量(含各类 *_API_KEY)都会随 agent 进程可见。属宿主行为,非本模板代码。
  • 预览 iframe 允许脚本且同源 — 产物/示例经 sandbox="allow-scripts allow-same-origin"(template-picker.tsx:544 与 preview-pane.tsx:297)加载;同源 + 允许脚本意味着产物内 JS 可达宿主页面上下文。本模板的 example.html 不含 <script>,风险来自将来生成的产物。
  • 产物运行期外链第三方 CDN — 共享指令要求 <head> 引 cdn.tailwindcss.com(必要时 jsdelivr / Google Fonts):断网或 CDN 变更会让产物外观退化;CDN 被投毒则脚本进入产物执行环境,模板侧无 SRI/完整性校验。
风险提醒:绿色,放心使用。判级口径:只判本 skill 目录(SKILL.md + example.html/example.md),宿主壳与产物外链不参与判级。目录内零脚本文件、零凭证读取、零写盘指令、无 SKILL.md 要求的运行时外链(SKILL.md 中的 JS 仅指产物内交互,未点名任何 CDN/字体/接口)。目录内实际出现的端点只有一处产物外链:example.html 的 <head> 引 cdn.tailwindcss.com(随包静态示例,预览时由浏览器加载)。 仅作说明、不改档的两点:① 宿主壳(loader.ts → assemblePrompt → agents/invoke.ts spawn 本机 CLI;claude 参数含 --permission-mode bypassPermissions,envFor 以 {...process.env} 全量透传环境变量)属宿主行为,已写入 verdict.risks;② 宿主注入的共享设计指令要求产物在 <head> 引 Tailwind Play / Google Fonts(属产物运行期外链)。

5第二遍独立确认

  • [ok] skill 目录资产面(脚本 / references / 数据 / 模板) — 目录实为 3 个文件:SKILL.md 与 example.html、example.md;无 scripts/、无 references 目录、无任何可执行文件(.sh/.py/.js/.mjs/.ts 零命中)。
  • [ok] 「无脚本、无网络、无凭证、无写盘」的反例搜索 — 对目录递归 token 扫描(api[_-]?key|token|secret|\.env|process\.env|child_process|fetch\(|curl |wget |npm |npx |exec\(|subprocess|writeFile|fs\.):零命中;SKILL.md 另按 http|CDN|cdn|font|API|api|fetch|Google|script 扫描,仅命中 font-semibold / font-black 这类字重类名,无端点。
  • [ok] 官方描述 vs 实际能力(有无夸大) — frontmatter description(可点击的功能性 Web 原型, 含导航、英雄区、特性区、CTA)与正文一致:描述承诺的版式要素都能在正文找到对应条目,未见正文未支持的越界承诺。
  • [ok] 外部资源/工具条目逐条回源 — external_deps 中的仓库级条目(Tailwind Play CDN / jsdelivr / Google Fonts / 本机 agent CLI)逐条回到 shared.ts 与 argv.ts 原文取证;本模板另有 example.html 的 cdn.tailwindcss.com 外链,已在该 example.html 原文中定位。
  • [ok] 宿主执行链(供 security.reason / verdict.risks 使用,不参与判级) — prompt 经 stdin 送入被 spawn 的本机 CLI(invoke.ts),HTML 从 stdout 分流捕获;claude 参数含 --permission-mode bypassPermissions、envFor 透传 process.env;预览 iframe sandbox="allow-scripts allow-same-origin"(template-picker.tsx:544 / preview-pane.tsx:297)。
  • [ok] 路径与 commit 一致性 — 工作副本 /var/ytdown/skills-portal/spy-repos/html-anything 的 git HEAD = 553ed98c283f9c0f489902d035416a972d6a9699(与任务表 pin 一致);skill.path=next/src/lib/templates/skills/prototype-web 下确有 SKILL.md,全仓无第二份同名模板。
  • [ok] "nav 滚动变色"是否要求外部 JS 依赖 — SKILL.md 只写 "- 添加交互: nav 滚动变色; 特性卡 hover 浮起; FAQ 可手风琴展开",未点名任何库或 CDN;example.html 除 Tailwind Play 外无其他脚本。
  • [ok] example.md 的虚构品牌素材是否构成外部数据抓取 — example.md 是仓库内静态文本(Inkstack 的定位/特性/评价/价格),由 /api/templates/<id>/example 作为 JSON content 返回给前端,无抓取行为。

6结论

  • 零代码零依赖:模板即提示词,靠目录约定注册,新增/替换模板不需要改任何 TS 代码
  • 整站骨架 + 响应式断点 + 交互反馈全覆盖,成品度要求写死("明天就能上线"),最接近可交付落地页
  • 与全局设计纪律协同:内容驱动数量 + 真实数据 + 单文件 HTML + 中文排版纪律(Noto Sans SC / 盘古之白)由宿主统一注入,模板只需专注自身版式
  • 示例闭环:随包 example.html 可在选择器里直接预览,example.md 提供配套输入,降低试用门槛
  • 适合:适合 SaaS/产品落地页的高保真原型:需要一整套从导航到页脚、能在浏览器里点着走、还能拿去当设计评审底稿的页面。
    不适合:不适合只想要定价页(用 pricing-page)或单屏设计(用 mobile-app);不适合需要真实后端/表单提交的工程需求——产物是静态原型;也不适合要求像素级品牌规范锁死的场景(模板只给"现代 SaaS 趋势"这类方向)。
    安装 agent 直装可复制
    ① 本站镜像 更新 2026-09-15
    方式 A · 人下载镜像包下载 prototype-web.tar.gz
    sha256: 6423f76bc45f7834…
    方式 B · JSON 格式安装指南,复制给 agent
    安装指南
    agent 读 JSON 指南后会自动从本站下载安装,无需更多说明。
    ② 上游 GitHub · 原始来源
    能访问 GitHub?直接去上游安装(实时版,可能已更新)GitHub 原始 ↗
    本页镜像锁定 commit 553ed98c28;上游为实时仓库。
    来源信息 GitHub 原始
    作者 / 仓库nexu-io / nexu-io/html-anything
    Stars8827
    最近推送2026-09-15
    本 skill commit553ed98c28
    许可Apache-2.0(仓库根 LICENSE 首两行为 "Apache License" 与 "Version 2.0, January 2004";pool.json 记 license=Apache-2.0)
    本站信息
    收录日期2026-09-06
    分类设计
    侦查报告AI 侦查 · 2 遍 · 2026-09-06
    本站镜像与 GitHub 原始是不同来源:本站锁定 commit 快照经 /r2 分发;GitHub 为实时上游,内容可能已更新。
    同分类邻近