SuperAPI AI 工具集

unslop-preflight

前端与建站

查看项目

更新于 10-24 16:17

技能介绍

Unslop Preflight(v1.15.0)定位为 AI 构建前端的预检与自主修复护栏。其角色设定为设计工程师与质量保障代理,目的是确保 AI 生成的前端实现具备可访问性与韧性,并避免典型的 AI 生成问题,例如脆弱布局、劣质文案和不可访问的交互。

用途:在进行任何较大范围的前端实现之前,运行 Unslop Preflight 评估仓库就绪度,把模糊需求转化为安全、确定性的交接(handoff)。

主要能力与使用方式:

  1. 识别项目模式。根据仓库现状选择模式:fresh-seed(无可信的产品/设计文档)、audit 或 existing-scan(需要质量审查)、root-cause-fix(用户报告界面破损、裁切、溢出或弹窗故障)、redesign(界面显得通用或脆弱)、implementation(已有交接产物,用户希望执行变更)、repair(需要安全的文档与源码修复)。
  2. 核验交接文档。检查 PRODUCT.md(产品背景、核心用户、品牌特质、本地化需求)、DESIGN.md(设计契约、令牌、字阶、间距规则、z-index 依据)、AGENTS.md(仓库专属代理指令、测试预期、变更规模策略)。任一文档缺失或过期时立即初始化: bunx unslop-preflight init
  3. 运行预检扫描与修复。推荐主循环为:

Instant preflight & safe auto-repair (Recommended)

bunx unslop-preflight autopilot --safe-fix --verify --report --strict 也可按需执行定向扫描: bunx unslop-preflight scan src --strict # Source code bunx unslop-preflight scan --prose # Prose and copy bunx unslop-preflight scan --feel # Interface polish 4. 评估就绪度。阅读 .unslop/ 目录下生成的报告;若项目处于 blocked 状态则不要继续实施。状态包括:🔴 blocked(仍有关键阻塞或规格缺口,停止工作);🟡 needs-spec-work(交接存在但模糊,先修复文档);🟢 agent-ready-with-fix-list(应用修复清单后重新运行);🔵 agent-ready(交接与源码均已验证,可放心推进)。

供应链安全检查清单:在合并或发布前,建议核验 package-lock.json、pnpm-lock.yaml 或 bun.lockb 的完整性;不要盲目运行 postinstall 脚本(强制 ignore-scripts=true);确保代码库中不存在硬编码密钥或 API 令牌。

安装方式(通过 skills.sh 全局安装): bunx skills add imMamdouhaboammar/unslop-preflight

适用场景:AI 辅助前端开发的前置质量把关、现有仓库的界面质量审计、破损界面的根因排查、通用化界面的重设计准备、以及执行变更前的交接文档整理与修复。

限制:资料未说明其支持的框架、浏览器环境、评分算法细节、报告字段结构、许可协议或收费情况;文档仅覆盖上述模式、命令与状态判定,其他功能未提供。