Phase 6
Content Design & Terminology

Introduction

同じ意味には、同じ言葉を使う

Knowledge OSでは、同じ操作を画面ごとに異なる言葉で表現してはいけません。 「追加」「登録」「取り込み」「アップロード」が混在すると、利用者は別の操作だと受け取ります。

この章で定義するもの

01 — Content Principles

1コンテンツ設計の原則

文章の基本順序

1. 何が起きたか
2. 利用者への影響
3. 次にできること

02 — Core Terminology

2基本用語辞書

使い分け

禁止する混在

• 同じ画面内で「資料」「ドキュメント」「ファイル」を無条件に混在させる
• 利用者向け画面で「Document」「Repository」「Vault」を使用する
• 資料一覧を「ファイル一覧」と呼ぶ
• 利用者向けの画面タイトルやナビゲーションに「資料一覧」を使用する（画面上は「資料」に統一する）

03 — Action Terminology

3操作語の使い分け

標準フロー

資料を追加 → ファイルを選ぶ → 内容を確認 → 資料を登録

使い分け例

04 — AI Terminology

4AI機能の用語

境界を明確にする

禁止表現

• AIが判断しました
• AIが正解を出しました
• 完全に正確です
• 資料を学習しました
• AIが記憶しました

05 — Buttons & Headings

5ボタン文言と見出し文言

ボタン文言

ボタンは「対象＋動詞」を基本とし、押した後の結果を予測できるようにします。

見出し文言

• 見出しは短い名詞または動詞句にする。
• 見出し末尾に句点を付けない。
• 英語と日本語を混在させない。
• 専門用語を見出しに使用しない。

06 — Success, Warning, Error

6成功・警告・エラーメッセージ

成功メッセージ

成功した対象と、必要に応じて次の操作を示します。

警告メッセージ

処理は続行できるが、確認が必要な場合に使用します。

エラーメッセージ

問題・影響・解決方法の順で書きます。

メッセージの標準構造

禁止表現

• 成功しました
• エラーが発生しました
• 入力値が不正です
• 処理に失敗しました
• Error 500
• 管理者に問い合わせてください

07 — Empty & Loading

7Empty StateとLoading文言

Empty State

現在の状態、できること、最初の操作を示します。

Loading文言

内部処理名ではなく、利用者の資料に対して何をしているかを示します。

時間がかかる処理

08 — Prohibited Terms

8禁止用語と技術用語の言い換え

専門用語を残してよい場所

• 開発者向けログ
• 詳細設定
• 診断情報
• 技術者向けマニュアル

09 — Tone & Style

9敬語レベルと文章表記

基本トーン

丁寧で落ち着いた日本語を使います。 接客文のように過剰に丁寧にせず、命令的にもならない表現を選びます。

使用しない表現

• 恐れ入りますが
• 大変申し訳ございませんが
• 誠に恐縮ではございますが
• 〜せよ
• 〜しなければなりません
• あなたの入力が間違っています

ひらがな・漢字

• 「下さい」ではなく「ください」
• 「致します」ではなく「します」
• 「出来ます」ではなく「できます」
• 「及び」ではなく「および」
• 「又は」ではなく「または」

記号

• 句点は文章末尾に付ける。
• 見出し・ボタンには句点を付けない。
• 感嘆符を多用しない。
• 三点リーダーは「…」を使用する。
• 括弧は全角の「（ ）」を基本とする。

10 — Numbers, Dates & Units

10数字・日付・時刻・容量の表記

相対時刻

• 直後：たった今
• 1時間以内：3分前、45分前
• 当日：14:30
• 過去日：2026年7月10日

使用しない表記

• 2026/07/12と2026-07-12の混在
• 2.358742 MB
• 12 item
• 数分前と正確な日時の無秩序な混在
• 令和表記と西暦表記の無計画な混在

11 — Standard Message Dictionary

標準メッセージ辞書

メッセージを新規作成する場合

1. 既存辞書に同じ意味の文言がないか確認する。
2. 主語・対象を具体的にする。
3. 利用者の次の行動を追加する。
4. 技術用語を一般的な言葉へ置き換える。
5. Phase 6へ標準文言として追記する。

12 — AI Instructions

Claude・Cursor・Codex向け指示

共通指示

Knowledge OS Design Principles v1.0.0
Phase 6「Content Design & Terminology」に従ってください。

必須条件：
- 同じ意味には同じ言葉を使う
- 利用者向けの標準語は「資料」とする
- 資料追加の入口は「資料を追加」とする
- ファイル選択は「ファイルを選ぶ」とする
- 登録確定は「資料を登録」とする
- 「ドキュメント」「インポート」「アップロード」を原則使用しない
- 画面上の英語を使用しない
- 技術用語は一般利用者向け表現へ置き換える
- 成功時は完了した対象を書く
- エラー時は問題、影響、解決方法を書く
- Empty Stateには次の操作を書く
- Loadingには現在の処理内容を書く
- 数字、日付、容量の表記を統一する

Claude向け

文章を作成する前に、標準用語辞書を確認してください。
既存の標準文言がある場合は、新しい言い方を作らず再利用してください。
高齢者でも読める、短く落ち着いた日本語にしてください。

Cursor向け

画面実装時に、既存画面の英語・専門用語・表記揺れを確認してください。
文言を変更する場合は、Phase 6の標準表現へ統一してください。
同じ意味のメッセージをコンポーネント内へ重複定義しないでください。

Codex向け

共通メッセージ、ラベル、状態文言を定数または辞書へ整理してください。
画面ごとに同じ意味の文字列を直接記述しない構造にしてください。
ただし、既存文言を自動的に一括変更せず、画面上の意味を確認してください。

13 — Review Checklist

コンテンツレビュー基準

用語

• 「資料」「ファイル」「文書」が正しく使い分けられている。
• 資料追加の入口が「資料を追加」になっている。
• 「インポート」「アップロード」が残っていない。
• 同じ操作に複数の言い方がない。

ボタン・見出し

• ボタンから操作結果を予測できる。
• 「OK」「実行」「送信」だけのボタンがない。
• 見出しが短く、日本語で統一されている。
• 技術用語が見出しに使われていない。

状態文

• 成功時に対象が分かる。
• 警告時に確認する内容が分かる。
• エラー時に解決方法が分かる。
• Empty Stateに次の操作がある。
• Loadingに処理内容がある。

表記

• 日付形式が統一されている。
• 時刻が24時間表記になっている。
• 容量が読みやすく丸められている。
• 数字と単位の間隔が統一されている。
• 英語と日本語が混在していない。

Closing

言葉も、製品のインターフェースです

利用者は、ボタンの形だけでなく、そこに書かれた言葉から操作を判断します。 同じ操作に異なる言葉を使うと、見た目が統一されていても、利用体験は統一されません。

最終原則

1. 同じ意味には同じ言葉を使う。
2. 利用者向けには「資料」を標準語とする。
3. 技術用語より業務の言葉を使う。
4. ボタンは操作結果が分かる文言にする。
5. 成功・警告・エラーを具体的に書く。
6. EmptyとLoadingにも意味を持たせる。
7. 新しい言い方を増やす前に、標準辞書を確認する。

Knowledge OS Design Principles v1.0.0
Phase 6 — Content Design & Terminology
Product Language and Terminology Guidelines