CiteStat/Wiki/Modern Web Guidance — bộ hướng dẫn web của Chrome cho AI viết code

Modern Web Guidance — bộ hướng dẫn web của Chrome cho AI viết code

SEO Kỹ thuật

Tóm tắt

Modern Web Guidance là bộ hướng dẫn (dạng "skill") giúp AI agent viết code nắm được cách làm web hiện đại và dữ liệu hỗ trợ của từng trình duyệt. Chrome phát hành bản 1.0 ngày 10/11/2026 qua bài viết của Philip Walton, có Firefox và Edge cùng tham gia dự án. Danh mục gồm 208 hướng dẫn trong 17 nhóm, từ hiệu năng, bảo mật đến form, khả năng tiếp cận và WebMCP. Đi kèm là legacy-scan, công cụ dòng lệnh dò các mẫu code lỗi thời ngay trong mã nguồn của bạn.

Giải thích đơn giản

Cứ hình dung đây là cuốn sổ quy chuẩn mà trợ lý viết code đọc trước khi động vào website của bạn: "form đăng nhập thì ô mật khẩu phải ghi current-password", "đừng giữ luồng chính quá 50 ms". Còn legacy-scan là người soát bản, khoanh đỏ những thói quen cũ đang nằm sẵn trong code.

Bộ công cụ gồm những gì

  • 208 hướng dẫn trong 17 nhóm: Visual Design, UI Atoms, UI Components, UI Behaviors, User Experience, Forms, HTML, CSS, JavaScript, WebAssembly, Performance, Accessibility, Security, Privacy, PWA, Built-in AI và WebMCP.
  • Mỗi hướng dẫn có địa chỉ riêng dạng developer.chrome.com/docs/modern-web-guidance/guides/<nhóm>/<slug>, ví dụ performance/identify-inp-causes.
  • legacy-scan đọc HTML, CSS, JavaScript/TypeScript, component của framework và package.json ngay trên máy, không gọi LLM.
npx modern-web-guidance@latest install
npx modern-web-guidance legacy-scan <path> --json

Bản legacy-scan 1.0.0 chạy 35 quy tắc tất định trên 33 hướng dẫn, theo trang quy trình hiện đại hóa của Chrome là khoảng 20% số hướng dẫn: chỉ những hướng dẫn mà code cũ dò được mà không báo nhầm. Cũng theo trang quy trình hiện đại hóa của Chrome, một quy tắc chỉ được phát hành khi đạt độ chính xác 80% ở bước so khớp tĩnh và 90% sau khi agent xác minh, đo trên code chưa từng thấy từ khoảng 45.000 kho mã nguồn mở. Không có cờ --fix: agent lấy hướng dẫn về (npx modern-web-guidance retrieve <guide-id>), sửa code, rồi quét và chạy test lại.

Những hướng dẫn liên quan đến SEO và AI search

  • Hiệu năng: break-up-long-tasks và identify-inp-causes (tác vụ trên luồng chính dài hơn 50 ms làm xấu INP), optimize-image-priority (ảnh LCP), optimize-script-priority, improve-next-page-load-performance (speculation rules), lazy-load-video-and-audio.
  • Bảo mật: security (CSP, HSTS, nosniff), secure-external-subresources (SRI, Referrer-Policy), trusted-types.
  • Form: forms, autofill-sign-in-form, autofill-sign-up-form (thuộc tính autocomplete).
  • Khả năng tiếp cận: accessibility, respect-os-text-scale (bật co giãn chữ theo hệ điều hành bằng meta name=text-scale).
  • Thiết kế hình ảnh: dark-mode (thẻ meta color-scheme).
  • PWA: install-web-app (web app manifest).
  • WebMCP: webmcp, agentic-forms, agentic-javascript-tools.

Chúng tôi tự chạy thử: legacy-scan 1.0.0 trên web app của chúng tôi báo 2 lỗi: ô mật khẩu ở form đăng nhập thiếu autocomplete="current-password", ô ở form đăng ký thiếu "new-password". Thêm hai giá trị đó vào, quét lại thì còn 0.

⚡Tại sao quan trọng

Bộ hướng dẫn viết cho agent lập trình chứ không cho công cụ tìm kiếm, nên làm theo nó tự thân không phải là tín hiệu xếp hạng. Nó quan trọng vì nhiều hướng dẫn sửa đúng những thứ công cụ tìm kiếm có đo: INP và LCP nằm trong Core Web Vitals, HTTPS và header bảo mật ảnh hưởng độ tin cậy, trang chặn phóng to thì trượt kiểm tra khả năng tiếp cận, còn WebMCP quyết định agent trong trình duyệt có làm xong việc trên site của bạn hay không. Ngày càng nhiều code website do agent viết; đây là chuẩn mà đội Chrome, Firefox và Edge muốn các agent đó làm theo.

🔍CiteStat kiểm tra thế nào

CiteStat quét trang mà người truy cập nhận được (HTML, header phản hồi, Lighthouse), không đọc mã nguồn của bạn, nên chỉ phủ những hướng dẫn để lại dấu vết trong trang. Đang kiểm tra: độ ưu tiên của ảnh LCP (fetchpriority, ảnh hero không lazy), script chặn hiển thị và preload, tác vụ dài trên luồng chính và INP (Total Blocking Time của Lighthouse, INP thực tế từ CrUX), script bên thứ ba thiếu mã integrity (SRI), header bảo mật (CSP, HSTS, nosniff), viewport chặn phóng to (phép thử WCAG 1.4.4, tách biệt với hướng dẫn text-scale), alt của ảnh và ngôn ngữ trang, web app manifest, và công cụ WebMCP. Một phần: lazy loading được tính điểm cho ảnh và chỉ báo cáo cho video và audio; có đọc font-display nhưng chưa đọc font dự phòng size-adjust. Có tính điểm: autocomplete trên ô đăng nhập và đăng ký (cảnh báo, trọng số 2, chỉ với trang có ô như vậy). Chỉ báo cáo, không tính điểm: speculation rules, Trusted Types trong header CSP, thẻ meta color-scheme, thẻ meta text-scale, preload của video và audio. Với mã nguồn của chính bạn, hãy chạy legacy-scan.

Điểm CiteStat

Không có quy tắc nào dẫn về trang này: đây là bản đồ các hướng dẫn, không phải một mục kiểm tra. Các mục kiểm tra nhắc ở trên được chấm điểm ở trang wiki riêng của chúng.

Độ khó sửa

Biên tập viên: Không liên quan | Lập trình viên: Dễ (cài, quét) đến Trung bình (sửa code) | AI Agent: Dễ