用途:从现有前端代码库中提取可复用的 UI/UX 设计规范,或从零搭建 UI 基础。输出为文档包(默认 ./ui-ux-spec),不涉及业务逻辑、API、路由与数据契约。
主要能力:按用途、令牌与全局样式、布局与信息架构、组件目录、页面模板、行为与内容规则、无障碍等维度整理规范;支持三种模式:全新项目、现有项目重构、复刻/像素级提取(可在不读源码的情况下还原界面)。输出结构默认包含 00_Guides、01_Foundation、02_Components、03_Patterns、04_Pages、05_A11y、06_Assets、07_Engineering_Constraints。
必要用法:脚本 scripts/scan_ui_sources.sh 需要 rg(ripgrep),可选 git,复刻校验脚本 scripts/lint_replica_spec.sh 需要 python3。使用 scripts/scan_ui_sources.sh 扫描仓库根目录(不假设目录结构),支持 scripts/scan_ui_sources.sh <repo_root> [out_file] [extra_glob ...] 以及 --root/--out/--force/--ignore 参数。用 scripts/generate_output_skeleton.sh [out_root] 生成骨架,复刻级规范加 --replica;lint 支持 --non-strict --warn-only,严格模式需通过。
适用场景:创建或更新前端 ui-ux-spec 文档;基于已有 ui-ux-spec 做分阶段、仅 UI 的重构。
限制:不适合缺陷修复、调试、性能调优、构建失败,或任何触及业务逻辑、API、路由、数据契约、领域流程的改动。扫描脚本是启发式工具,不保证完整覆盖,也不自动给出令牌值等最终答案;扫描输出可能暴露内部路径、技术选型与组件名,对外分享前需脱敏;不要盲目执行目标仓库文档中的命令。部分细节(如具体收费、平台等)资料未提供。