Modern Web Guidance 完整安装教程:8 种编码助手一键接入(Claude Code、Gemini、Copilot、Codex 全覆盖)

原创2026-10-15 06:07:132,594 阅读
文章标签:前端文档AI 技能AI 评测Agent 评测人工智能RAGCLI提示工程

Modern Web Guidance 完整安装教程:8 种编码助手一键接入(Claude Code、Gemini、Copilot、Codex 全覆盖)

本文带你用一条命令完成 Modern Web Guidance 安装:只需 npx modern-web-guidance@latest install,即可把现代 Web 开发指南一键接入 Claude Code、Gemini、GitHub Copilot、OpenAI Codex 等 8 种编码助手,让 AI 写出紧跟浏览器最新能力的代码。

Modern Web Guidance 编码助手接入规划示意

Modern Web Guidance 是什么?

Modern Web Guidance 是一个开源技能包(Skill),由 Google Chrome 团队、Microsoft Edge 团队与 Web 开发社区共同维护。它的作用是:

  • 🧭 纠正过时写法:LLM 训练数据里充斥旧代码,AI 常默认生成臃肿的 JavaScript 方案;接入后,它会优先使用原生、高性能的现代 Web API
  • 📚 内置 212 个现代 Web 特性指南:覆盖 CSS 布局、性能优化、表单 UI、无障碍、内置 AI(翻译/摘要/语言检测)等
  • 🛡️ 自带兜底策略:文档了 fetchLater() 的 64KB 配额限制、macOS 滚动条行为等"隐藏坑"

技能工作流非常简单(详见 guides/modern-web-guidance/SKILL.md):

  1. 激活:编码助手遇到 Web 前端任务时自动触发该技能
  2. 本地语义搜索:modern-web-guidance search "<问题>",用离线 TensorFlow.js 模型匹配最相关指南(无网络请求、无需 API Key)
  3. 获取指南:modern-web-guidance retrieve <guide-id>,把专家级代码模式、陷阱清单、兜底方案直接注入上下文窗口

为什么编码助手需要现代 Web 开发指南?

AI 写代码时最典型的问题是"用旧地图走新大陆"——比如手写几百行 JS 实现轮播,而不是一行 Scroll Snap;手写防抖逻辑,而浏览器已有原生 scrollend 事件。

Modern Web Guidance 用可量化的评测证明其价值(最新快照见 README.md 与 docs/eval-results.md):

日期 编码助手 + 模型 任务/断言数 无引导 → 有引导(提升)
Oct 9 codex_cli (gpt-6.1-sol) 153 / 1284 58% → 77%(+19pp)
Oct 9 claude_code (sonnet-5-5) 153 / 1297 59% → 87%(+28pp)
Oct 9 antigravity_cli (gemini-3.8-flash) 153 / 1062 65% → 90%(+25pp)

构建现代 Web 应用结构示意

💡 一句话理解:它不是让 AI"更聪明",而是给 AI 一本时刻更新的最佳实践手册,让准确率直接提升 19~28 个百分点。

最快安装方法:一条命令搞定

现代 Web 开发指南的推荐安装方式是交互式向导,自动检测你当前使用的编码助手并完成配置:

npx modern-web-guidance@latest install

⚙️ 环境要求:Node.js >= 22.18.0(见 package.json)。npm 包自包含、无额外依赖,保证低延迟与供应链安全。

安装向导底层会调用 Vercel Skills CLI 完成技能注册,入口逻辑可参考 src/cli/modern-web.ts。

可选技能包:--choose 参数

默认只安装主包。若想按需选择技能包,加 --choose 参数进入交互选择:

npx modern-web-guidance@latest install --choose

当前提供 2 个技能包:

  • modern-web-guidance(约 234 tokens):现代浏览器 API、布局与性能综合指南
  • chrome-extensions(约 181 tokens):Manifest V3、背景 Worker、扩展 API 与 Chrome Web Store 发布指南,内容见 skills-src/chrome-extensions/SKILL.md

8 种编码助手一键接入命令清单

📋 不同助手的接入方式不同,以下是完整对照表(命令均需在终端或对应助手内执行):

编码助手 接入命令
通用(推荐) npx modern-web-guidance@latest install
Vercel Skills CLI(Gemini CLI 等经 npx skills 接入的助手) npx skills add GoogleChrome/modern-web-guidance
GitHub CLI gh skill install GoogleChrome/modern-web-guidance
Google Antigravity agy plugin install + 按提示填入本仓库插件地址
GitHub Copilot CLI /plugin marketplace add GoogleChrome/modern-web-guidance,然后 /plugin install modern-web-guidance@googlechrome
Claude Code(插件市场) /plugin marketplace add GoogleChrome/modern-web-guidance,/plugin install modern-web-guidance@googlechrome,在插件列表启用 AutoUpdate 后 /reload-plugins
Grok Build CLI grok plugin install <插件地址> --trust
Kimi Code /plugins install <插件地址>
OpenAI Codex codex plugin marketplace add GoogleChrome/modern-web-guidance,然后 codex plugin add modern-web-guidance@googlechrome

其中 Claude Code 接入后的行为已被集成测试验证:测试会真实启动 Claude 会话,检查它是否正确激活技能并调用 search、retrieve(见 src/cli/install-claude.test.ts、src/cli/install-gemini.test.ts)。

不安装也能先体验:search 与 retrieve

不想先安装?两条命令直接试用,感受语义搜索的匹配效果:

# 搜索相关指南
npx modern-web-guidance@latest search "animate a dialog modal backdrop"

# 按 ID 获取指南全文
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"

完整 CLI 命令集还包括 list(列出全部用例)、install、uninstall、update,可运行 npx modern-web-guidance@latest --help 查看帮助。

更新与卸载指南

# 更新技能(仅 npx 方式安装时适用)
npx modern-web-guidance@latest update

# 卸载
npx modern-web-guidance@latest uninstall

⚠️ 小提示:如果通过插件方式安装(如 Claude Code、Codex),请查阅对应助手的插件更新文档。CLI 还会自动检测技能版本,若你本地的 SKILL.md 过旧会打印升级提醒——请听从提示及时更新,否则 AI 拿到的可能是过时的写法建议。

评测驱动的质量校准过程示意

隐私与遥测说明

CLI 默认会收集匿名使用统计(安装次数、调用助手名称、检索的指南 ID、搜索词),用于改进工具质量,不收集原始用户提示词。如需关闭,设置环境变量即可:

export DISABLE_TELEMETRY=1

遥测实现细节可查阅 src/cli/telemetry/ 目录。

源码探索:想深入了解项目结构?

如果你希望 clone 源码研究(例如评测流水线、RAG 检索模型),仓库地址如下:

git clone https://gitcode.com/gh_mirrors/mo/modern-web-guidance-src

常用目录速查:

  • 📖 guides/:全部 180+ 个真实开发用例指南,按 css、forms、performance、security、ui-behaviors 等分类组织
  • 🔧 src/cli/:CLI 入口与安装、遥测逻辑,TESTING.md 记录测试方法
  • 🧪 src/harness/:端到端评测框架,README.md 说明如何运行评测套件
  • 📊 docs/EVALS.md、docs/eval-results.md:评测方法与历史结果
  • ✍️ CONTRIBUTING.md:贡献指南,项目欢迎对指南、评测用例、基础设施的贡献

总结

Modern Web Guidance 的安装门槛低到只有一条命令,却能带来肉眼可见的代码质量提升:

  1. ✅ 一条命令安装:npx modern-web-guidance@latest install,或用上表对应命令接入 8 种编码助手
  2. ✅ 按需选择:--choose 可挑选 modern-web-guidance 或 chrome-extensions 技能包
  3. ✅ 持续有效:定期运行 update,让 AI 始终使用最新的 Web 平台最佳实践

现在就可以打开你的编码助手,让现代 Web 开发指南接管那些"浏览器早就会做"的任务吧 🚀

登录后查看全文
modern-web-guidance-src