Modern Web Guidance 完整安装教程:8 种编码助手一键接入(Claude Code、Gemini、Copilot、Codex 全覆盖)
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 是一个开源技能包(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):
- 激活:编码助手遇到 Web 前端任务时自动触发该技能
- 本地语义搜索:
modern-web-guidance search "<问题>",用离线 TensorFlow.js 模型匹配最相关指南(无网络请求、无需 API Key) - 获取指南:
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) |
💡 一句话理解:它不是让 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 的安装门槛低到只有一条命令,却能带来肉眼可见的代码质量提升:
- ✅ 一条命令安装:
npx modern-web-guidance@latest install,或用上表对应命令接入 8 种编码助手 - ✅ 按需选择:
--choose可挑选modern-web-guidance或chrome-extensions技能包 - ✅ 持续有效:定期运行
update,让 AI 始终使用最新的 Web 平台最佳实践
现在就可以打开你的编码助手,让现代 Web 开发指南接管那些"浏览器早就会做"的任务吧 🚀


