modern web guidance可以通过交互式cli安装到支持的编程agent中,也可以不安装,直接检索和读取指南。它提供web平台、兼容性、性能和无障碍方面的资料;legacy-scan用于发现需要检查的旧写法,扫描结果仍需结合项目目标和实际浏览器范围判断。

Modern Web Guidance官方安装向导命令
安装或直接检索
准备可运行npx的Node.js环境,在项目目录执行安装向导,按当前Agent选择目标。只想查看指南时,可先使用search及retrieve,不必安装到全部工具。
npx modern-web-guidance@latest install npx modern-web-guidance@latest search "animate a dialog modal backdrop" npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
扫描当前代码库
npx modern-web-guidance@latest legacy-scan .
在项目根目录执行扫描,结合输出定位对应代码,再读取相关指南。项目涵盖Popover、对话框、容器查询、原生表单、性能调度等主题,不应把“存在更现代API”直接等同于项目必须重写。

Modern Web Guidance官方检索和代码扫描命令
按兼容范围确认改动
修改前保留项目的目标浏览器、无障碍交互和回退要求,修改后运行原有测试、构建及必要的交互检查。该工具为Agent提供依据,不替代代码评审,也不能保证某项新平台能力在所有终端上同时可用。











