
2026/05/31 16:09
ウェブサイトの仕様書
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
本テキストは、従来のインフラストラクチャを現代の AI ニーズと橋渡しするための汎用的でプラットフォーム非依存の Web スペシフィケーションを導入する。WHATWG、W3C、IETF RFCs、WCAG、MDN といった権威あるソースに基づき、この規格は
<title>、検索可視化プロトコル、アクセシビリティ、セーフティヘッダー、/.well-known/ パス、Core Web Vitals、訪問者の同意シグナル、エレガントな失敗処理、言語・ロケールを含む 10 の主要カテゴリをカバーし、主観的な意見ではなく確立された規格を通じて有効性を保証する。その最も重要な革新は、「AI 的可読性」を定義することであり、llms.txt という専用のファイル(Accept: text/markdown でアクセス可能)を用いて AI エージェントが Web の機能らを正しく解釈できるように支援する。プロジェクトは完全に透明に公開されており、「GitHub で編集」のリンクが付与されプルリクエストが歓迎されることで継続的な改善が可能となっており、各ページで出典がクレジットされている。また、認証なしで読み込めるオープンソースの MCP サーバー(https://mcp.specification.website/mcp)を提供しており、互換性のあるエージェントにその仕様を利用する方法を教えるための Agent Skill も公開されている。最終的に、このイニシアチブは全てのスタック(WordPress、Next.js など)の開発者に、よりアクセシブルで検索に優しく且つ互換性の高い Web サイトを作成する力を付与し、人間訪問者と AI システム双方が Web コンテンツと効果的に対話するための明確な経路を提供する。本文
優れたウェブサイトのための技術仕様書
あらゆるウェブサイトに備えるべきプラットフォーム非依存の機能定義です。人間の利用者と AI エージェントを両方対象にしています。
構成とカテゴリー
本仕様書は、広く受け入れられている規格に基づき以下10 つの領域に分類されています。
- HTML、head、ドキュメントの基礎
- すべてのページに必要な基本要素
- 検索可視性
、サイトマップ、正規化 URL(canonical)、構造化データrobots.txt
- WCAG に準拠したルール
- 全ての利用者が快適に利用できるよう設計されたアクセシビリティ要件
- ヘッダー、転送プロトコル、ポリシー
- 訪問者の安全を保つための設定(HSTS など)
の標準パス.well-known/
、security.txt
、llms.txt
などdotwellknown/security
- AI エージェント向け要素
- クローラーや LLM に対して解釈可能なメタデータ
- パフォーマンス最適化
- コアウェブバイタル、キャッシュ戦略、画像・フォントの最適化、ネットワーク挙動
- 同意と訪問者の意思尊重
- Cookie バナー、シグナル、プライバシー設定
- 障害対応(リカバリ)
- エラーページ、オフライン状態の処理、適切なリダイレクト
- 言語・ロケール対応
- 書写方向、翻訳コンテンツの管理
規格と原則
各トピックは、単なる意見ではなく、以下のような公式規格へのリンクに基づいています。
- WHATWG:HTML などの基本仕様
- W3C:アクセシビリティ(WCAG)やセマンティクスのガイドライン
- IETF RFC:インターネット標準プロトコル
- MDN:実践的な実装参考資料
- その他:現代のウェブを定義する組織の推奨事項
プラットフォーム非依存性
本仕様書は特定の技術スタックに依存しません。以下のいずれかの環境でも不変のガイドラインとして機能します。
- CMS:WordPress、Drupal、TYPO3 など
- フレームワーク:Next.js、Astro、Hugo など
- バックエンド:Django アプリなど
- 純粋な HTML
実装に関するヒントは、仕様の趣旨に沿うように設計されています。
オープンソースと協働
コミュニティ参加を歓迎し、透明性を担保しています。
- 各ページに「GitHub で編集する」リンクが配置されています。
- プルリクエスト(PR)の投稿を歓迎します。
- すべてのページには、ソースへの出典明記が含まれています。
エージェントによる照会機能
全体仕様は、認証不要で読み取り専用のオープン MCP サーバーとして提供されており、あらゆる互換性のあるエージェントが利用可能です。
また、「いつ・どのように利用すべきか」を教える
Agent Skill も公開されています。
MCP サーバー構成例
以下の設定を使用してサーバーを登録します:
{ "mcpServers": { "specification-website": { "transport": "http", "url": "https://mcp.specification.website/mcp" } } }
ご利用方法
このサイトを利用する際の3 つのステップです。
- 01 オードット(監査)
- チェックリストを実行します。
- 各項目は「該当するか? はい/いいえ」というシンプルな判断で進められます。
- 02 学ぶ
- 任意の項目をクリックすると、その意味と重要性を説明できます。
- 具体的な実装方法についても学習可能です。
- 03 改善
- 欠落項目や陳腐化した情報、不足しているトピックを発見したらプルリクエストを開いてください。
- 必ずソースの記載を含めてください。