structured-answer

name	structured-answer
description	ユーザー向けの回答、要件整理、説明、計画、レビュー、仕様、要約を作成するときに使う。自然言語だけでは条件、状態、多重度、期間、時刻、境界値、制約、推論、計算が曖昧になりうる場合、表、デシジョンテーブル、Mermaid 図、計算式、境界値表で一意化する。推測で補った図表要素は必ず明示する。

Structured Answer

基本原則

自然言語の曖昧さを減らし、壊れやすい文章説明を構造化表現に置き換える。

言葉による説明を極力減らす。関係、構造、流れ、状態遷移、時系列など、図形で説明できることは原則として Mermaid などで図解し、文章は図の前提・例外・結論を補う最小限に留める。

回答に次が含まれる場合は、図表または表を使う。

• 条件分岐
• 状態または遷移
• 多重度、構成、エンティティ間の関係
• 期間、時刻、範囲、境界値
• 実行できる行為、できない行為の制約
• 条件から導く分類、判定、推論
• 計算式、算出方法、アルゴリズム

記法の選択

型	記述したいこと	兆候となる言い回し	推奨記法
事実	用語間の関係、構成、多重度	「〜は…である」「〜は…で構成される」	Mermaid classDiagram / erDiagram、階層図、用語定義表
契機	ある状況で何かを起こす	「〜の場合…をする」「〜であれば…する」	Mermaid flowchart、アクティビティ図風フロー
制約	実行できる／できない行為の制限	「〜だけができる」「〜の場合のみ」	デシジョンテーブル
推論	条件が真のとき新たに判定される値	「〜の場合…とみなす」「〜で判定する」	デシジョンテーブル
計算	数式・アルゴリズムで求める値	「〜から…を算出する」	計算式、境界を示す表

必ず構造化するもの

複数条件の組み合わせで結果が変わる場合は、デシジョンテーブルを使う。

条件 \ ケース	1	2	3
会員区分 = 優良	Y	N	N
年間購買額 ≥ 10万	-	Y	N
割引券を送付する	X	X	-
通常案内を送付する	-	-	X

凡例: 条件 Y = 真、N = 偽、- = 無関係。動作 X = 実行する、- = 実行しない。

範囲、日付、時刻、年齢、個数、上限・下限、以上・未満などは境界値表を使う。

範囲	開始を含む	終了を含む	結果
0 <= x < 10	はい	いいえ	A
10 <= x <= 20	はい	はい	B

Mermaid の使い方

関係や流れが視覚的に検証しやすくなる場合は Mermaid を使う。

flowchart TD
  A[入力] --> B{条件}
  B -- はい --> C[動作]
  B -- いいえ --> D[動作なし]

エンティティ、所有、構成、多重度には classDiagram または erDiagram を使う。

classDiagram
  顧客 "1" --> "0..*" 注文
  注文 "1" --> "1..*" 注文明細

推測の扱い

遷移、分岐、関係、境界ルールを勝手に補わない。

元の情報やユーザーの指示に明記されていない要素を図表へ含める場合は、推測であることを明示する。

• 日本語回答では ※推測 を付ける。
• 英語回答では inferred を付ける。
• Mermaid が対応している場合、推測した関係は点線で示す。
• 推測した要素は事実として断定せず、レビューで確定すべき項目として扱う。

出力前チェック

最終回答の前に確認する。

• 言葉で説明している箇所のうち、図解に置き換えられるものが残っていないか。
• 条件分岐に隠れたケースがないか。
• 境界値の含む／含まないが明示されているか。
• 多重度やエンティティ関係が必要な箇所で示されているか。
• 推測した箇所に ※推測 または inferred が付いているか。
• 図表が文章より小さく明確になっているか。