ディシジョンツリー：分岐ガイダンスのルールと例

ディシジョンツリーとは、各回答が次の質問または最終的な推奨事項を選択する一連の質問のことです。正しいアクションが読者が特定できる事実に応じて実際に変化する場合に使用します。すべての人に同じアドバイスを装飾するために使うものではありません。

データエクスポート失敗への最初の対応を選ぶ

1. エクスポートにエラーメッセージが表示されていますか？
はい → 正確なメッセージをコピーし、質問2に進んでください。
いいえ → ジョブがまだ「処理中」と表示されているか確認してください。表示されている場合は、指定された処理時間まで待ちます。表示されていない場合は、エクスポートを1回再実行してください。

2. メッセージは権限が拒否されたと表示していますか？
はい → 管理者にエクスポート権限を依頼してください。終了。
いいえ → 日付範囲を狭めて1回再試行してください。再度失敗した場合は、メッセージとエクスポートIDをサポートに送信してください。終了。

このレンダリングされた要素は、基本的な契約を示しています。すべての選択肢は識別可能で、すべてのパスは進行し、すべてのパスは次のアクションまたはエスカレーションで終了します。

この要素が重要な理由

「状況によります」は正直ですが、不完全です。このフレーズに遭遇した読者は、答えが何に依存するのかを発見し、どの条件が該当するかを判断し、散文から推奨事項を再構築する必要があります。ディシジョンツリーはそれらの依存関係を明示的にします。漠然とした条件付けを、事実を観察し、1つの分岐を選び、終端点に基づいて行動するという境界のあるシーケンスに変換します。

これにより、ワーキングメモリの負荷が軽減されます。読者はすべての例外を頭に保持する代わりに、現在の選択肢のみを評価します。また、不確実性を可視化します。人がノードに回答できない場合、ツリーは推測を促すのではなく、確認、測定、または専門家へと誘導できます。これは、自信はあるが誤った分岐が時間の損失やリスクを生み出す可能性がある、トラブルシューティング、資格判定、購入選択、ポリシー解釈において特に重要です。

機械抽出可能性とは、クローラー、検索システム、AI回答システム、またはコンテンツ変換ツールが、各質問、その許容される回答、および次のノードまたは終端点を復元できることを意味します。連続的な「もしこれなら、もしかするとあれ、ただし…」という散文は、それらの関係を文法の中に隠します。型付きツリーはそれらを安定した識別子と明示的なターゲットを持つレコードとして公開します。機械は、どのパラグラフがどの条件を修飾するかを推論することなく、ルート start → has-error → permission-denied → request-access を保存できます。

パターンを適用する前に、要素作成ルール に従ってください。目的が外観に優先します。全員が同じアクションを順番に実行する場合はシーケンスはステップリストのままであり、読者がオプションを並べて検査する必要がある場合は比較は比較のままです。前の回答によって次に何が起こるべきかが変わる場合にのみ、ディシジョンツリーを使用してください。

使用するタイミング

以下のすべての条件が満たされる場合にディシジョンツリーを使用します。

1. 少なくとも1つの意味のある推奨事項が、読者またはその状況によって提供される回答に依存している。
2. 各決定が、観察可能で相互に排他的な選択肢で表現できる。
3. 分岐をたどることで、有用なコンテキストを隠すのではなく、無関係な選択肢が除去される。
4. すべてのルートが、アクション、結論、名前付きフォールバック、またはエスカレーションで終了する。
5. 著者が各条件が推奨事項を変更する理由を説明できる。

強力な使用例としては、既知の症状の診断、製品カテゴリの選択、ポリシーの適用可否の確認、実装ルートの選択、および日常的なプロセスをエスカレーションすべきタイミングの判断が含まれます。

類似しているがよりシンプルな形式にすべきケース：

• 1つの推奨事項に複数の理由がある場合： 通常の説明散文を使用します。回答によって結果が変わることはありません。
• 固定された手順： 順序付けられたステップを使用します。各ステップ内の分岐は、主要なルートを見えにくくします。
• 読者が共有基準で比較しなければならないオプション： 比較表を使用します。ツリーは比較後にオプションを推奨することもありますが、証拠を置き換えることはできません。
• パーソナリティクイズ： 好みは重複する可能性があり、スコアリングは累積的になる場合があります。これは排他的なツリーではなく、評価モデルです。
• オーディエンスセグメントのリスト： 読者が単に自分のロールを選択して並列コンテンツを受け取る場合は、ペルソナ切り替えツールを使用します。
• 複雑な計算： 複数の数値入力が組み合わさる場合は、計算機を使用します。範囲を数十の分岐に変換すると精度が失われます。
• 偽装されたセールスファネル： すべてのパスが同じ製品を推奨する場合、ツリーは診断の幻想を作り出します。推奨事項とその限界を直接述べてください。

配置場所

読者が決定事項、その範囲、および最初のノードに回答するために必要な事実を理解した直後にツリーを配置します。トラブルシューティング記事では、共有の安全確認と正確な症状をツリーの前に置きます。購入ガイドでは、読者をカテゴリに誘導する前に、基準と対象となるオプションセットを定義します。ポリシーコンテンツでは、例外による分岐の前に、権威あるルールと適用範囲を記載します。

正確な配置ルール：

• H2と、ツリーが解決する決定を命名する1文でツリーを導入します。
• 定義、測定、前提条件を最初のノードの前に置きます。未定義の用語に分岐ラベルを依存させないでください。
• 根拠となる証拠を、それが正当化する終端点の近くに保持するか、各終端点から同じページ上の可視の証拠セクションにリンクします。
• 長いツリーの後にサマリーを配置し、読者が選択した終端点を確認し、次に何をすべきかを理解できるようにします。
• ツリーは最終的なコールトゥアクションの前に配置します。アクションは診断を中断するのではなく、結論に従うべきです。

ディシジョンツリーは、別のディシジョンツリー、ペルソナタブセット、または分岐の選択に必要な情報を隠すアコーディオンのすぐ隣に配置してはいけません。警告をそれが該当する危険な条件から切り離したり、明示的な「ステップに戻る」終端点なしで順序付けられた手順を中断したり、推奨事項の証拠を提供する比較の前に表示したりしてはいけません。ノード内にプロモーションカードを配置しないでください。商業的压力があると、中立的なルーティングを信頼することが難しくなります。

構成要素

構成要素は8つの部分から成ります。

1. タイトル： 「エクスポート復旧ルートを選択する」など、読者の目標として決定を命名します。
2. スコープステートメント： ツリーがカバーする状況と除外する状況を記載します。
3. 開始ノード： 1つの曖昧でないエントリーポイントを提供します。
4. 質問ノード： 複数の条件を含む意見ではなく、1つの観察可能な事実を尋ねます。
5. 分岐ラベル： 同じ論理カテゴリ内で相互に排他的な回答を提供します。
6. コネクター： 各回答を、安定したIDを通じて1つの次のノードまたは1つの終端点にマッピングします。
7. 終端終端点： 結論、アクション、証拠リンク、または安全なエスカレーションを提供し、ルートが完了したことを視覚的に示します。
8. フォールバック： 「不明」、「該当なし」、データ欠落、または安全でない状況を、推測を強制することなく処理します。

視覚的な矢印はプレゼンテーションであり、関係性そのものではありません。レンダラーが狭い画面でツリーを垂直にレイアウトする場合でも、ソースデータはすべての分岐のターゲットを識別できなければなりません。

デザイン例

すべてのデザインバリアントは同じノードとターゲットの契約を使用します。視覚的な新規性ではなく、推論構造とビューポートに応じて選択してください。

バイナリ診断ツリー

各ノードには「はい」と「いいえ」の分岐があります。ステータスが存在する、テストに合格した、権限が存在するなど、事実が真にブール値である場合に使用します。「いいえ」の解釈が難しくなるため、否定質問は避けてください。

マルチチョイス選択ツリー

ノードは、契約期間、環境、主要な制約など、重複しない3つまたは4つのカテゴリを提供します。ラベル内でカテゴリの境界を定義してください。「小」「中」「大」は範囲なしでは使用できません。

段階的資格判定ツリー

初期のノードで不適格なルートを除外し、後のノードで適格な選択肢を絞り込みます。ポリシー、サービス、または統合の適用可能性に使用します。後の選好で上書きできないため、失格となる安全および法的条件を最初に配置してください。

例外出口付きリニアツリー

メインパスは通常のシーケンスを継続し、時折の分岐がリカバリまたはエスカレーションに抜けます。ほとんどの読者が1つのルートをたどり、例外が稀な場合に使用します。例外が手順に再合流する場合は、復帰ポイントを正確にラベル付けしてください。

インタラクティブな1質問ビュー

フルツリーがビューポートに対して密度が高すぎる場合にのみ、一度に1つの現在のノードを表示します。進捗コンテキスト、「戻る」、「最初からやり直す」、テキストによる結果サマリー、および非インタラクティブなアクセシブルビューを含めてください。完全なソースツリーは、クライアント側フェッチなしで利用可能でなければなりません。

パラメータ

親はツリーのIDと開始点を所有します。繰り返されるノードは独自のプロンプトまたは終端点コンテンツを所有し、分岐レコードは回答ラベルとターゲットを所有します。

終端点には分岐がありません。質問には少なくとも2つの分岐があり、各ターゲットは同じツリー内のノードに解決されます。データは非巡回でなければなりません。つまり、どの分岐も祖先に戻ってはいけません。手順に再合流するリカバリルートは、ツリー内でループを発生させるのではなく、「ステップ3に戻る」で終了する必要があります。

構文とコード例

3つの形式すべてが同じ正規レコードを記述します。レンダラーはレイアウトを変更しても構いませんが、ソース順、ラベル、ターゲット、終端点、および完全な非インタラクティブ読み取りパスを保持しなければなりません。

ポータブルMarkdownディレクティブ

:::decision-tree{id=export-recovery variant=binary start=has-error}
## Choose an export recovery route

::item{id=has-error kind=question branches="yes:permission-error|no:still-processing"}
### Does the export show an error message?
Choose from the status shown in the export history.
::

::item{id=permission-error kind=question branches="yes:request-access|no:retry-smaller"}
### Does the message say permission is denied?
::

::item{id=still-processing kind=endpoint}
### Check the processing window
Wait until the stated window ends, then restart the export once.
::

::item{id=request-access kind=endpoint}
### Request export permission
Ask an administrator for access before trying again.
::

::item{id=retry-smaller kind=endpoint}
### Retry a smaller export
Reduce the date range once; if it fails, send the error and export ID to support.
::
:::

コンパクトな branches 属性は | で区切られた label:target ペアを使用します。ラベルにはいずれの区切り文字も含めることはできません。ネストされた分岐レコードを持つプラットフォームは同じ値を構造的に保存しても構いませんが、エクスポート時には明示的なラベルからターゲットへのマッピングを再現する必要があります。

Hugoショートコード

{{< decision-tree title="Choose an export recovery route" id="export-recovery" variant="binary" start="has-error" >}}
  {{< decision-node id="has-error" kind="question" title="Does the export show an error message?" branches="Yes:permission-error|No:still-processing" >}}
  Choose from the status shown in the export history.
  {{< /decision-node >}}
  {{< decision-node id="permission-error" kind="question" title="Does the message say permission is denied?" branches="Yes:request-access|No:retry-smaller" >}}{{< /decision-node >}}
  {{< decision-node id="still-processing" kind="endpoint" title="Check the processing window" >}}
  Wait until the stated window ends, then restart the export once.
  {{< /decision-node >}}
  {{< decision-node id="request-access" kind="endpoint" title="Request export permission" >}}
  Ask an administrator for access before trying again.
  {{< /decision-node >}}
  {{< decision-node id="retry-smaller" kind="endpoint" title="Retry a smaller export" >}}
  Reduce the date range once; if it fails, send the error and export ID to support.
  {{< /decision-node >}}
{{< /decision-tree >}}

これはHugoアダプター仕様であり、任意のネストされたリストでツリーを模倣するための指示ではありません。名前付きパラメーターのみを使用し、レンダラーが欠落したターゲット、重複ID、サイクル、および十分な分岐のない質問ノードを拒否することを要求します。

WordPressブロック

<!-- wp:amicited/decision-tree {"title":"Choose an export recovery route","id":"export-recovery","variant":"binary","start":"has-error"} -->
  <!-- wp:amicited/decision-node {"id":"has-error","kind":"question","title":"Does the export show an error message?","branches":[{"label":"Yes","target":"permission-error"},{"label":"No","target":"still-processing"}]} -->
  <p>Choose from the status shown in the export history.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"permission-error","kind":"question","title":"Does the message say permission is denied?","branches":[{"label":"Yes","target":"request-access"},{"label":"No","target":"retry-smaller"}]} /-->
  <!-- wp:amicited/decision-node {"id":"still-processing","kind":"endpoint","title":"Check the processing window"} -->
  <p>Wait until the stated window ends, then restart the export once.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"request-access","kind":"endpoint","title":"Request export permission"} -->
  <p>Ask an administrator for access before trying again.</p>
  <!-- /wp:amicited/decision-node -->
  <!-- wp:amicited/decision-node {"id":"retry-smaller","kind":"endpoint","title":"Retry a smaller export"} -->
  <p>Reduce the date range once; if it fails, send the error and export ID to support.</p>
  <!-- /wp:amicited/decision-node -->
<!-- /wp:amicited/decision-tree -->

WordPressの親ブロックは内部ブロックを決定ノードに制限し、公開前にターゲットを検証し、完全なリストまたは同等のアクセシブルな構造をサーバーレンダリングします。エディターのみの接続線は信頼できる情報源ではありません。

例

良い例

購入ガイドで「デバイスは電源なしで動作する必要がありますか？」と尋ねます。はいはバッテリー駆動のオプションに誘導します。いいえは「1つの固定された場所に設置されますか？」と尋ねます。その回答は設置型またはポータブル型のオプションに誘導します。各終端点はカテゴリを命名し、決定的な制約を説明し、読者を適格製品の可視比較に送ります。「わからない」は、意図する設置場所の測定とコンセントアクセスの確認に誘導します。

これは、質問が読者が観察できる事実に関するものであり、分岐が重複せず、各回答が不適切なカテゴリを除外するため、機能します。このツリーは、価格、機能、証拠の比較なしに特定の製品を選択したふりをするのではなく、カテゴリを推奨します。

悪い例

ソフトウェアページで「より良い結果を望みますか？」と尋ねます。はいもまだも「デモを予約する」に誘導します。次の質問では、ほとんどの購入者が3つすべてを重視するにもかかわらず、訪問者がスピード、品質、または節約のどれを重視するかを尋ねます。すべての終端点で同じ製品の主張が繰り返されます。

これは、選択肢が相互に排他的でも決定を変えるものでもないため失敗です。質問はニーズを診断するのではなく同意を収集し、分岐は単一のコールトゥアクションを隠しています。直接的な価値提案と証拠に置き換えてください。異なる実装が本当に異なる制約に適合する場合は、それらの測定可能な制約について尋ね、「この製品は適合しません」といった正直な終端点を許可してください。

スキーママークアップとアクセシビリティ

Schema.orgには DecisionTree タイプはありません。ページに独立して1つの順序付けられた手順が含まれていない限り、要素を HowTo とラベル付けせず、回答が単なる分岐コントロールである場合に質問ノードを FAQPage とラベル付けしないでください。ツリーは内部コンテンツデータ（ノード、選択肢、ターゲット、終端点レコメンデーション）の生成に役立つ場合がありますが、デフォルトではパブリックなスキーマプロパティを提供しません。

アクセシビリティのためには、ツリータイトルに見出しを、完全な静的フォームに順序付きリストまたはネストされたリストを使用してください。各質問と終端点には可視テキストが必要です。コネクターは色、線の方向、または空間的な位置のみに依存できません。「はいの場合、権限確認に進みます」のように、関係性の中に回答ラベルを繰り返してください。スクリーンリーダーは図を解釈せずにルートを理解できる必要があります。

ツリーがインタラクティブな場合、選択肢にはネイティブボタンを使用してください。現在の質問をラベル付けされたリージョンで公開し、フォーカスを新しい質問に移動するか、抑制されたライブリージョンを通じてそれを通知し、「戻る」と「最初からやり直す」コントロールを提供してください。ブラウザのズームを無効にしたり、フォーカスをトラップしたり、フォーカス時に選択肢を変更したりしないでください。終端点で選択されたルートをテキストで保存し、読者が結果にどのように到達したかを確認できるようにしてください。

すべてのノードと終端点は、非アクティブなノードが視覚的に非表示になっている場合でも、サーバーレンダリングされたHTMLで提供される必要があります。非常に大規模なエキスパートシステムではパフォーマンス上それが非現実的な場合、完全なアクセシブルな代替手段を公開し、インタラクティブなアプリケーションをこのコンテンツ要素とは別のツールとして扱ってください。

作成ルール

目標は、洗練された印象ではなく、最短の正当化可能なルートです。

• タイトルは「選択する…」「確認する…」「適切なものを見つける…」のように決定として記述します。3〜12語に抑えてください。
• 質問ごとに1つの事実を5〜18語で尋ねます。常に同じ観察可能な回答を持つ場合を除き、「および」や「または」で結合された条件は分割してください。
• 質問ごとに2〜4つの分岐を使用し、決定レベルは5つまでにしてください。深さが増すと読者がルートを見失い、モバイル図が扱いにくくなります。
• 兄弟分岐は相互に排他的であり、意図された範囲に対して集合的に十分であるようにしてください。不確実性が現実的な場合は「わからない」または「該当なし」を追加してください。
• 1つのカテゴリから並列ラベルを使用します。すべてはい/いいえ、すべて範囲、すべて環境、またはすべて明示された制約。
• 数値の境界を正確に記述します。「小規模企業」ではなく「50拠所未満」を使用してください。境界値での範囲の重複を避けてください。
• 各終端点に2〜10語のアクションタイトルと、なぜそれが続くのか、何をすべきか、いつエスカレーションすべきかを説明する最大80語を提供してください。
• 最も安全で最も安価な識別チェックを早期に配置してください。すでにルートを決定している可視のステータスや権限確認の前に、専門家による測定を求めてはいけません。
• 証拠、制限、および結果を可視化してください。ツリーは決定を整理しますが、推奨が正しいことを証明するものではありません。
• すべてのパスを文章として声に出してテストしてください：「回答がXだったため、Yに進みます。」その文章が非論理的であれば、分岐が間違っています。

機密の個人データ、無資格の医療または法的診断、隠された価格、安全警告、複数フィールドのフォーム、または不可逆的なアクションをノード内に決して配置しないでください。行き止まり、ラベルなしのコネクター、「状況によります」とだけ言う終端点、または読者に無限に質問を繰り返させるサイクルを決して作成しないでください。

これを使用する投稿タイプ

postTypes フロントマターはサポートされるセットを定義します。この表に存在することは、その投稿タイプがコンテンツが実際に分岐する場合にツリーを使用できることを意味し、すべてのページで要素を必須にするものではありません。

QAチェックリスト

• ページには実際の依存関係が含まれている：少なくとも1つの回答が次の質問または終端点を変更する。
• タイトルとスコープが、ツリーが解決する決定と除外する決定を正確に示している。
• 開始ノードが1つあり、すべての質問に2〜4つの分岐があり、すべてのターゲットが存在する。
• 兄弟選択肢は相互に排他的で、並列ラベルを使用し、現実的な不確実性をカバーしている。
• すべてのパスが5レベル以内でアクション、結論、フォールバック、またはエスカレーションで終了する。
• 孤立した終端点がなく、自分自身や祖先を指すノードがなく、読者が無限ループに陥ることがない。
• すべての終端点がなぜそれが続くのかを説明し、証拠または制限を利用可能にしている。
• ツリーが固定手順、並列比較、計算、警告、または直接的な推奨を置き換えていない。
• すべてのテキストと関係性がサーバーレンダリングされたHTMLに存在し、コネクターラインなしで理解できる。
• キーボードユーザーが選択、戻る、再開、および可視フォーカスで結果に到達できる。
• フォーカスとステータスの変更が通知され、フォーカスがトラップされたり、スクリーンリーダーが繰り返し中断されたりしない。
• 狭い画面のレンダリングがソース順を保持し、すべてのコネクターをラベル付けし、水平パンが不要である。
• 静的フォールバックとインタラクティブ結果が、同じ回答に対して同じ終端点を生成する。
• レビュー担当者がすべてのパスを歩き、境界値をテストし、同じ結果につながる分岐に異議を唱えた。

よくある質問

以下の質問は、ツリーがドラフトされた後にのみ頻繁に現れる実装上の選択をカバーしています。中核的なテストはシンプルのままです。分岐は結果を変える事実を表し、すべてのルートは安全に終了しなければなりません。