mcpField
P
plain-language

plain-language

github.com/mgiffordデザイン・UI57174 回インストール6 週間前に更新
リポジトリ

plain-language について

plain-languageは、ウェブコンテンツの作成・編集・レビューに使うアクセシビリティスキルです。構成、表現、読みやすさ、支援技術での確認方法を案内します。

主な機能

  1. 01読者に沿ったページ構成
  2. 02短い文と能動態の活用
  3. 03平易な語句と用語の説明
  4. 04見出し・リスト・略語の確認
  5. 05可読性と支援技術のチェック項目

活用シーン

  1. 01一般向けウェブ文章の書き直し
  2. 02内容の分かりやすさのレビュー
  3. 03スクリーンリーダーや読み上げへの適合確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mgifford/accessibility-skills --skill plain-language

インストール後、Claude Code で/plain-languageを入力して読み込まれたか確認します。

同梱ファイルREADME.mdSYNC.md

詳細

わかりやすい言葉でのアクセシビリティスキル

正規の参照元:mgifford/ACCESSIBILITY.md の examples/PLAIN_LANGUAGE_ACCESSIBILITY_BEST_PRACTICES.md このスキルはそのファイルを基にしています。迷った場合は、例の内容を優先してください。

Web コンテンツの作成、編集、レビュー時に、これらのルールを適用してください。 プロジェクトにコンテンツの作成または編集が含まれる場合にのみ、このスキルを読み込んでください。

このスキルは content-design/SKILL.md を補完します。コンテンツ作業では両方を読み込んでください。 わかりやすい言葉は、より深いレベルでの実践です。コンテンツデザインは構造的なパターンです。


基本方針

わかりやすい言葉とは、読者が必要な情報を見つけ、理解し、初めて読んだときに行動できるように書くことです。コンテンツをわかりにくくすることではありません。読者の時間を尊重し、不要な障壁を取り除くことです。

わかりやすい言葉は、次のユーザーにとって主要なアクセシビリティ対策です。

  • 認知障害、学習障害、知的障害のあるユーザー
  • 読解力が低いユーザー、またはページの言語が母語ではないユーザー
  • ストレスや疲労を感じているユーザー、危機的状況にあるユーザー
  • スクリーンリーダーでコンテンツにアクセスするユーザー(読み返しに時間がかかるため)
  • リーダーモードやテキスト読み上げを利用するユーザー(複雑な構文を理解しにくいため)

WCAG 3.1.5「読解レベル」(AAA)では、一般読者向けのコンテンツを小学2年生から中学2年生相当以下の読解レベルにすることを目標としています。 わかりやすい言葉は Opquast の要件(ルール5、7)でもあり、 Web Sustainability Guidelines にも沿っています。 簡潔なコンテンツは、データ転送量と読書時間を削減します。


重大度の基準(このスキル)

レベル意味
Criticalコンテンツが対象読者にまったく理解できず、不可欠な指示に従えない
Serious難解な専門用語や複雑な文構造が、認知障害のあるユーザーにとって大きな障壁となる
Moderate読解レベルが中学2年生相当を超えている。略語が説明されていない。受動態が多用されている
Minor障壁にはならないものの、短縮や明確化ができる箇所がある

支援技術に関する背景

わかりやすい言葉が支援技術(AT)にどのように役立つかは、技術によって異なります。

ATわかりやすい言葉の効果
スクリーンリーダー(NVDA、JAWS、VoiceOver)短い文は聞き直す際の認知負荷を軽減します。見出し階層は移動を助けます
リーダーモード(Firefox/Edge/Safari)視覚的な階層が取り除かれるため、構造だけで意味が伝わるようにする必要があります
Edge の読み上げ機能/TalkBack の TTS節が多い長文は、聞いて理解するのが難しくなります
音声コントロール明確で短い見出しやラベルは、音声で指定するナビゲーション対象として使いやすくなります
画面拡大一度に見える範囲が限られるため、重要な情報を先に示すとスクロールを減らせます
認知アクセシビリティツール(例:Helperbird、Recite Me)コンテンツを再構成するため、複雑な構造よりも単純な構造のほうが適切に再構成されます

重要:文章よりも構造を優先

わかりやすい言葉は、構造から始まります。文章が平凡でも、構造が整ったページのほうが、文章が美しくても構造が不十分なページよりアクセシブルです。

1ページにつき1つのトピック、1段落につき1つの考え
✗ This page covers our history, our services, our pricing, and how to contact us.

✓ Separate pages for: About us / Services / Pricing / Contact
重要な情報を先に示す

まず結論を示し、その後に根拠を述べます。段落の内容を理解するために、最後まで読まなければならない状態にしないでください。

✗ After reviewing several options and consulting with our legal team, we have
  decided that applications submitted after 31 March will not be accepted.

✓ Applications close 31 March. We will not accept late submissions.
逆ピラミッド型:最も重要な情報 → 補足の詳細 → 背景情報

この構造は、スクリーンリーダーで見出しを使って移動するユーザー、検索エンジンを利用するユーザー、そしてすぐに答えを必要としている危機的状況のユーザーに役立ちます。


重大:文と段落の長さ

長い文や段落は、認知障害、ディスレクシア、読み書き能力の低いユーザーにとって重大な障壁になります。

文:

  • ほとんどの文は、最大でも15~20語を目安にします
  • 1文につき主節は1つにします。従属節は独立した文に移します
  • 可能な限り、曖昧さや限定表現を取り除きます。「注意すべき点として」→ 削除

段落:

  • 一般向けのウェブコンテンツでは、段落は最大3~5文にします
  • 段落ごとに主題を1つにします
  • 段落の間には空行を入れます(インデントだけにしないでください)
✗ Due to the fact that the application process requires a significant amount
  of documentation to be submitted in advance of the deadline, which is
  31 March for this financial year, applicants who have not yet gathered
  their supporting materials should begin doing so immediately.

✓ The application deadline is 31 March.
  Gather your supporting documents now — the process takes time.
  See the checklist below for what you need.

重大:能動態

受動態は動作を行う人を隠し、認知負荷を高めます。 特別な理由がない限り、能動態を使ってください。

✗ Decisions will be made by the committee.
✗ Applications must be submitted before the deadline.
✗ Your account may be suspended if payment is not received.

✓ The committee will decide.
✓ Submit your application before the deadline.
✓ We will suspend your account if we do not receive payment.

受動態を意図的に使う場合:

  • 動作を行った人が本当に不明な場合:「3人が負傷しました。」
  • 動作を行った人が重要でない場合:「このフォームは2019年に設計されました。」
  • 否定的な表現を和らげたい場合:「間違いがありました。」(まれに使い、慎重にしてください)

重大:平易な言葉

読者がすでに知っている言葉を使ってください。専門家向けには専門用語が適切ですが、一般向けには平易な言い換えが必要です。

使わない表現使う表現
utiliseuse
commencestart
endeavourtry
prior tobefore
in the event thatif
at this point in timenow
facilitatehelp
demonstrateshow
subsequentlythen / after
approximatelyabout

分野固有の用語(法律、医療、技術):専門家向けでない限り、別の用語集ではなく、初出時に本文中で定義します。


<p>Your <abbr title="General Data Protection Regulation">GDPR</abbr> rights
   allow you to request a copy of your personal data.</p>


<p>To exercise your GDPR rights, contact our data protection team.</p>

中程度:読みやすさのレベル

一般向けのコンテンツでは、8年生以下(Flesch-Kincaid)を目標にします。 10年生を超えると中程度、一般向けコンテンツで12年生を超えると重大な問題です。

読みやすさのレベルを確認するツール:

  • Hemingway Editor — 複雑な文、受動態、学年レベルを強調表示します
  • retext-readability — CIに組み込める読みやすさのリンター
  • Microsoft Wordに組み込まれているFlesch-Kincaidスコア(校閲 → アクセシビリティの確認)

学年レベルは目安であり、絶対的なルールではありません。法律や規制に関する文章では、正確さを保つために学年レベルが上がることがあります。その点を説明し、正式な文章とともに平易な要約を示してください。


中程度:略語と頭字語

展開されていない略語は中程度の障壁になります。スクリーンリーダーが誤読する可能性があり、新しい読者には意味がわかりません。

**ルール:**ページごとに初出時に展開します(サイトの最初のページだけではありません)。

<p>The <abbr title="Web Content Accessibility Guidelines">WCAG</abbr> are
   published by the W3C. WCAG version 2.2 is the current standard.</p>

<abbr title="...">を使うと、支援技術や、視覚のあるユーザーがホバーしたときに展開形を提示できます。 スクリーンリーダーによる<abbr>の扱いには一貫性がありません。title属性の展開形を読み上げる支援技術もあれば、読み上げないものもあります。<abbr>を使うかどうかにかかわらず、初出時には必ず本文中に展開形を書いてください。


中程度:リストと文章

並列する項目が3つ以上ある場合は、リストを使います。文章の中にリストを埋め込むと、構造が見えにくくなり、認知負荷が高まります。

✗ You will need to provide your full name, date of birth, current address,
  email address, and a copy of your identification document.

✓ You will need:
  • Full name
  • Date of birth
  • Current address
  • Email address
  • A copy of your identification document

順不同のリストには<ul>を、順番どおりに実行する必要がある手順や並びには<ol>を使います。


中程度:指示と手順

手順には番号を付けます。状況説明より先に操作を示します。

✗ After logging in, which you can do from the homepage, click the Settings
  icon in the top-right corner of the screen, then select Account.

✓ To update your account:
  1. Log in at [homepage link].
  2. Click Settings (top-right corner).
  3. Select Account.

軽微:口調とインクルーシブな言葉遣い

  • 読者には「あなた」、組織には「私たち」と呼びかけます
  • 全体を通して性別を限定しない言葉を使います。単数形の「they」は文法的に認められ、広く受け入れられています。「he or she」は避けてください
  • 障害を比喩として使うなど、障害者差別的な表現は避けます(「見て見ぬふりをする」「懸念に耳を貸さない」「孤立している」)
  • 他の文化圏では伝わらない可能性のある、文化固有の慣用表現は避けます(「おおよその見積もり」「途方もないことをする」「すぐに動き出す」)

軽微:ページタイトルと見出し

  • ページの <title> には、ページとサイトを示す内容を含めます:「会社概要 | Acme Corp」
  • 各ページの <h1> は1つにします。<title> と一致させるか、その内容をよく反映させます
  • 見出しは具体的にします。「はじめに」だけでは具体性がありません。「平易な言葉の原則について」は具体的です
  • 見た目を整えるために見出しを使わず、代わりに CSS クラスを使います

テスト用チェックリスト

公開前に、次の項目を確認します。

  1. 読みやすさスコア: 一般向けコンテンツでは、Flesch-Kincaid の学年レベルを8以下にします
  2. 文の確認: 特別な理由がない限り、25語を超える文がないことを確認します
  3. 受動態の確認: Hemingway Editor では受動態が緑色で強調表示されます
  4. 略語の確認: すべての略語を初出時に展開します
  5. 平易な言葉の確認: 上記の「代わりに使う言葉」表にある言葉に置き換えます
  6. リーダーモードのテスト: Firefox または Safari のリーダーモードで開きます。CSS なしでも意味が通じますか?見出しは適切ですか?内容は論理的な順序になっていますか?
  7. 音読テスト: Edge の音声読み上げまたは macOS VoiceOver を使います。紛らわしい文は、読み上げると明らかに不自然に聞こえます

完了条件チェックリスト

  • 読解レベル:一般向けの場合、Flesch-Kincaid の学年レベルが8以下
  • 文:平均20語以下。特別な理由がない限り、30語を超える文がない
  • 全体を通して能動態を使用。受動態は意図的な場合に限る
  • 各段落の冒頭に重要な情報を配置
  • すべての略語と頭字語を、各ページで初出時に展開
  • 専門用語を初出時に文中で定義
  • 並列する項目が3つ以上ある場合はリストを使用
  • 順序に沿った手順には番号付きリストを使用
  • 誰もが含まれる性別中立的な表現を使用
  • ページの <title> を「ページ | サイト」形式にする
  • <h1> は1つにし、見出しを具体的かつ階層的にする
  • リーダーモードのテストに合格
  • 音声読み上げのテストに合格

主な WCAG 基準

  • 3.1.1 ページの言語(A)— <html> に lang 属性を指定
  • 3.1.2 部分的な言語(AA)— 異なる言語の要素に lang を指定
  • 3.1.5 読解レベル(AAA)— 一般向けコンテンツでは学年レベル8以下を目標にする
  • 1.3.1 情報と関係性(A)— 見出しの階層、リストのマークアップ
  • 2.4.2 ページタイトル(A)— 内容がわかるページタイトル

参考資料

基準の見通し: WCAG 3.0 は策定中です。平易な言葉に関する要件は縮小ではなく拡大が見込まれ、特に認知アクセシビリティに関する要件が拡大すると予想されます。 https://www.w3.org/TR/wcag-3.0/ を確認してください。

コメント