用 AI 编码智能体开发 Chrome 扩展：Modern Web Guidance 来了

21次阅读

原文文档：https://developer.chrome.com/docs/extensions/ai/build-with-ai?utm_source=ext_sidebar#modern_web_guidance

随着 AI 编码助手普及，很多开发者开始用大模型生成 Chrome 扩展代码。但现实痛点很突出：大模型训练数据滞后，经常输出废弃 API、旧版 manifest V2 写法，生成的代码不符合 Chrome 扩展最佳实践，甚至提交 Chrome 网上应用店直接被打回。

Chrome 官方推出 Modern Web Guidance，就是专门解决这个问题的一套技能包，让 AI 编码智能体写出规范、现代、可直接交付的 Chrome 扩展程序。

🤖 什么是 Modern Web Guidance

Modern Web Guidance 是 Chrome 官方提供给 AI 编码 Agent 的领域知识库（Skill 技能包），把 Web 平台知识、浏览器最佳实践、最新 API 模式直接注入 AI 编码上下文，引导 AI 避开过时写法，输出符合现代 Web 标准的代码。

其中专门包含 chrome‑extensions 扩展开发技能，给 AI 补齐 Chrome 扩展开发的专属知识，主要做到三件事：

最新 API 知识：弥补大模型训练截止时间差，提供新版扩展 API、Manifest V3 规范，不会输出已经废弃的旧接口。
官方最佳实践：内置 Chrome 扩展团队多年沉淀的开发规范，权限管理、Service Worker、Side Panel 等场景的正确写法。
商店发布就绪：辅助生成应用商店提交所需信息，自动识别权限说明，降低上架审核失败概率。

除此之外这套技能包还覆盖性能、无障碍、浏览器内置 AI API 等内容，AI 生成代码时会自动考虑硬件约束、模型下载策略、安全降级方案等细节。

✨ 完整工作流：AI 写扩展 + Agent 调试

这份官方文档完整展示了一套端到端开发链路，不只是生成代码，还打通调试环节：

给 AI 编码 Agent（Antigravity、Gemini CLI、Claude Code 等）安装 Modern Web Guidance，加载 chrome‑extensions 技能。
自然语言描述你的扩展需求，AI 基于官方知识生成 Manifest V3 完整扩展源码。
借助 Chrome DevTools for agents，AI 智能体可以直接操控 Chrome 实例：安装 / 重载扩展、触发扩展动作、检查 popup、侧边栏、Service Worker，直接在浏览器里调试排错，不用开发者手动复制粘贴代码测试。

简单理解：以前 AI 只输出代码文本；现在 AI 懂 Chrome 扩展规则，还能直接操作浏览器完成运行、调试、验证。

🛠️ 快速安装使用

官方推荐使用modern‑web‑guidance CLI 工具，安装后技能包可以自动更新，不用手动维护知识库文件。

交互式选择安装：

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

执行后跟随向导，选择你的 AI 编码工具，勾选 chrome‑extensions 和 modern‑web‑guidance 技能即可。

也可以使用命令直接添加扩展技能：

npx skills add GoogleChrome/modern-web-guidance --skill chrome-extensions

支持 Gemini CLI、Claude Code、Antigravity 等主流编码 Agent，部分 Agent 还可以通过插件市场直接安装插件版本。

💡 适合哪些开发者？

想快速原型 Chrome 扩展，但对 Manifest V3 全套 API 不熟；
使用 AI 写扩展，总是遇到 API 过时、代码不规范、商店审核报错；
希望 AI 不止生成代码，还能辅助调试、输出可直接发布的工程。

注意：Modern Web Guidance 是给 AI 编码智能体的知识库，它不会替代开发者审查代码，生成的代码依然需要人工校验逻辑、安全、权限合理性。

📝 小结

AI 写浏览器扩展已经不再是简单的 “prompt 生成代码”。Chrome 官方的 Modern Web Guidance，把浏览器官方权威知识交给 AI 编码 Agent，解决大模型知识滞后、输出老旧代码的痛点，搭配 Agent 可调用的 DevTools 调试能力，把 AI 辅助扩展开发推向完整工程化流程。

如果你在尝试 AI 驱动 Chrome 扩展开发，这份官方指南值得阅读实践。