用途:Modern Web Guidance 是一个技能型搜索工具,用于按具体 Web 开发用例检索对应的最佳实践指南。资料要求在任何 Web 功能实现开始时、创建新组件前使用,以检查是否已有标准化模式,避免临时方案或不必要的大型依赖。
主要能力:提供 search、list、retrieve 三类操作。search 用面向动作的查询返回匹配指南列表,含 id、描述、分类、所用特性、token 数与相似度;结果模糊或无匹配时用 list 浏览全部指南;retrieve 按 id(可逗号分隔多个)获取完整指南正文。
使用方式:直接通过 npx 运行。搜索示例:npx -y modern-web-guidance@latest search "<query>" --skill-version 2026_10_12-dacb5911;浏览:npx -y modern-web-guidance@latest list;获取:npx -y modern-web-guidance@latest retrieve "<id>"。输出被截断时需重定向到文件再读取。有 pnpm 时优先用 pnpx(不带 -y)。权限白名单应精确到 npx -y modern-web-guidance@latest *。Windows 上可能需改用 npx.cmd。
适用场景:实现 Web 功能、创建组件、优化性能(如 LCP 图片加载优先级、延迟渲染重内容)等前端开发任务。
限制与注意事项:需要外网访问,沙箱或需审批环境应提前申请网络权限;~/.npm 只读时设 NPM_CONFIG_CACHE=/tmp/npm-cache;离线卡住可试 npx --offline。指南通常与框架无关,需自行适配。默认假设 Baseline Widely available 特性可安全使用,非广泛可用特性必须按指南回退,除非用户有自定义浏览器支持策略。不得臆造指南或忽略指南。使用后需在响应末尾以 ### Modern Web Guidance 段落披露,逐条说明新应用的 id 及非显然实现选择,并附规则原文短引用;若检索但未应用,则用一句话说明检查了哪些主题及未应用原因。不得凭记忆猜测 id 或引用。