编程智能体经常生成臃肿且过时的 JavaScript,因为它们的训练数据充斥着过去几年的过时代码模式。为了解决这个问题,Google Chrome、Microsoft Edge、Mozilla Firefox 和 MDN 合作推出了“现代 Web 指南”,这是一套将 Web 平台专业知识和浏览器兼容性数据直接嵌入到智能体上下文窗口中的技能集。

一个显示带有侧边栏和代码编辑器的编程助手环境的深色主题界面。
现代 Web 指南项目旨在改进如该界面所示的编程智能体的输出。github.com

这张图片展示了现代 Web 指南项目旨在协助的编程智能体环境类型。

弥补 AI 训练中的知识差距

虽然前沿编程模型能够生成功能正常的代码,但它们往往缺乏生产级软件所需的真实世界现代实现模式的密度。现代 Web 指南通过提供针对性的准则来弥补这一差距,帮助模型正确构建它们经常误用的 API。

该工具专注于引导智能体转向原生解决方案。例如,它鼓励使用 HTML 或 CSS 功能来执行比自定义 JavaScript 代码更少的任务,这通常会带来更好的性能和更高的可访问性。

“现代 Web 指南是一套将 Web 平台专业知识、最佳实践和浏览器兼容性数据直接嵌入到您的编程智能体中的技能集。”

— GitHub - GoogleChrome/modern-web-guidance: Keep your coding agent up to date with the latest web best practices

核心领域与功能覆盖

该指南涵盖了广泛的现代 Web 能力,包括 140 项 CSS 和布局功能,如容器查询(container queries)、子网格(subgrid)和 oklch 颜色空间。它还包括 74 项 JavaScript 和 API 功能,如 Scheduler API、Temporal 和 Translator API。

一个显示各种 Web 功能及其对应类别和状态的表格。
指南涵盖的 250 项现代 Web 功能综合列表的一部分。github.com

此表格提供了 CSS 和 JavaScript 等领域广泛功能覆盖的视觉示例。

现代 Web 指南覆盖范围: 现代 Web 功能总数 250; CSS & 布局功能 140; HTML & DOM 功能 36; JavaScript & API 功能 74
现代 Web 指南覆盖范围github.com

图表由 HN Digest 根据 github.com 报告的数字绘制;数值按来源所示。

特定的关注领域包括“负责任的回退(Responsible Fallbacks)”,引导模型使用轻量级替代方案而非沉重的 polyfill,以及“内置 AI”,利用设备上的浏览器 API 执行摘要生成和语言检测等任务。

一个显示特定 Web 平台 API 及其兼容性数据的详细表格。
包含在指南中的浏览器兼容性数据和平台级 API 的示例。github.com

此视觉效果支持对项目中包含的特定 JavaScript 和 API 功能的描述。

现代化工作流与局限性

1.0 版本引入了一个现代化工作流,用于分析 HTML、CSS、JavaScript 和 package.json 文件,以识别安全的升级机会。这允许开发人员使用智能体系统地将过时的权宜之计替换为现代原语。

目前,此工作流在狭窄范围内使用静态分析以确保可预测的结果。项目团队计划在未来扩展此功能,包括“智能审计(agentic audits)”,即让 AI 直接对代码进行推理,而不仅仅是匹配已知模式。

Hacker News 读者的反应

  • 亲身经验: 一位评论者分享说,他们之前开发了自己的工具来解决 AI 生成代码使用冗长的过时模式而非现代功能的问题。 评论 ↗
  • 质疑: 一位用户表示担忧,该项目可能会导致 AI 模型优先遵循主导浏览器的指南,而非更广泛的 Web 标准。 评论 ↗
  • 替代方案: 一位评论者建议,与其要求安装,不如将准则托管为可搜索的 Markdown 索引,智能体可以通过 HTTP 请求获取。 评论 ↗
  • 质疑: 另一位读者认为,将这些实践注入智能体可能会导致模型产生准则的“平均值”,他们认为这可能是无效的。 评论 ↗

以上为 Hacker News 讨论中观点的摘要,并非经过核实的事实。 阅读完整讨论 ↗