SuperAPI AI 工具集

build

前端与建站

查看项目

更新于 10-15 22:40

技能介绍

用途:帮助不会写代码的站点/应用所有者在互联网上拿到一个真实可用的产品。使用者扮演设计、工程与 QA 负责人,所有者无需读代码、跑命令或猜测是否可用。

主要能力:按六个阶段推进,不跳步——(1) 澄清需求并写一页规格,通常一轮 3 至 5 个问题,每题给出合理默认值;(2) 选最简单可行的技术栈,如纯 HTML+CSS、表单服务、Stripe 托管结账、静态站点生成器或 Next.js 加托管后端;(3) 写代码前先确定设计方向,含排版、色彩、间距、圆角、动效与一个标志性元素;(4) 小步构建,每步可见可查并提交保存点,计算类逻辑先写失败测试;(5) 在 375/768/1440 三种宽度用真实浏览器做 QA;(6) 上线并交接说明。

工具(仅用 Python 3 标准库,可从本技能目录或复制 tools/ 到项目中运行):

  • python3 tools/serve.py site/ 本地预览,支持 --spa、--clean-urls、--lan;--lan 会额外打印一个可在手机(同一 Wi-Fi)打开的地址。
  • python3 tools/sitecheck.py site/ 爬取站点并报告失效链接/锚点/资源、缺失 title/viewport/description/lang/doctype、无 alt 或尺寸的图片、过大图片、混合内容、重复 id、未标注表单字段、无名称的图标按钮、占位链接、lorem ipsum、localhost URL、noindex、favicon、og:image 等,支持 --json、--external、--strict、--list-rules,有错误时退出码为 1。
  • python3 tools/contrast.py 计算 WCAG 对比度,可用 --css styles.css --pair ink:paper 检查设计令牌并给出通过建议。

另附清单:checklists/design.md(设计方向、反模式、打磨)、checklists/qa.md(浏览器 QA)、checklists/ship.md(部署与交接)。

基本准则:先有证据再下结论,未验证要明说;对所有者用平实语言解释;涉及花钱、公开发布或账号操作前先征得同意,登录由所有者本人完成;内容用真实素材,不编造评价、客户数、logo 等;设计大胆但克制,默认不用渐变、玻璃拟态和发光效果,移动优先;构建与检查循环有上限,两轮完整 QA 后报告遗留问题。

限制:工具只能检查可机械验证的部分(链接、资源、标签、属性、对比度数值),品味、清晰度与说服力仍需人工看截图;sitecheck.py 不执行 JavaScript,单页应用需浏览器检查;报告通过不代表销售、搜索排名或完整 WCAG 合规;无法做浏览器或 Playwright 截图时须明确说明视觉 QA 未做;不代所有者登录账号、输入支付信息,未经同意不公开发布。