personal-visual-explainers/sample/majiai-diagram/.claude/skills/diagram-maji/references/term-dictionary.md
2026-03-20 15:51:26 +09:00

4.2 KiB
Raw Permalink Blame History

技術用語→やさしい言葉 変換辞書

変換の原則

  1. 機能で命名する: 「何をするものか」で名前をつける
  2. 身近な比喩を添える: 日常生活での類似物を示す
  3. 初出時に解説ボックス: 最初に出てきたとき必ず説明

よく使う変換表

プログラミング基礎

技術用語 やさしい言葉 たとえ
コールバック関数 チェック係 「何かあったら呼んでね」と登録しておく処理。電話の折り返しと同じ
API 窓口 銀行の窓口。決まった書類を出すと、決まったサービスを受けられる
インターフェース 約束事 「この形式で頼めば対応します」というルール
パラメータ 指示内容 注文票に書く内容
引数 渡す情報 窓口に提出する書類
戻り値 受け取る結果 窓口から返ってくる書類
変数 名前付きの箱 ラベルを貼った引き出し
関数 処理の塊 自動販売機(入れると出てくる)

非同期・イベント

技術用語 やさしい言葉 たとえ
非同期処理 待たずに進む処理 レストランで注文後、席で待つ。厨房の前で立ち尽くさない
イベント きっかけ ドアベルが鳴る、ボタンを押す
リスナー 見張り役 インターホンの前で待機している人
トリガー 発動条件 「このボタンを押したら」という条件
フック 割り込みポイント 会社のセキュリティゲート
ハンドラ 対応係 イベントが起きたとき対応する担当者

データ・構造

技術用語 やさしい言葉 たとえ
JSON データの書き方 住所録の書式
オブジェクト 情報のまとまり 名刺1枚名前、電話番号、住所がセット
配列 順番付きリスト 番号札のついた待合室の椅子
スキーマ 設計図 入力フォームの項目一覧
バリデーション 入力チェック 書類の不備確認

セキュリティ・権限

技術用語 やさしい言葉 たとえ
認証 本人確認 パスポートを見せる
認可 許可 「この部屋に入っていいですよ」というOK
トークン 入場券 映画のチケット
セッション 接続状態 電話がつながっている間
パーミッション 権限 「閲覧OK、編集NG」のような許可レベル

AI・エージェント

技術用語 やさしい言葉 たとえ
プロンプト 指示文 AIへの依頼書
ストリーミング 逐次表示 手紙を1文字ずつ読み上げる
コンテキスト 文脈・前提情報 会話の流れ、今までの話
エージェント 自動で動くAI 自分で判断して動く秘書
ツール AIが使える道具 秘書が使えるファイル、電話、パソコン

用語解説ボックスの書き方

<div class="term-explain">
  <div class="flex items-start gap-4">
    <i data-lucide="lightbulb" class="w-8 h-8 text-purple-500"></i>
    <div>
      <div class="term-word text-xl font-bold">「コールバック関数」とは?</div>
      <div class="term-meaning text-lg mt-2">
        難しそうな名前ですが、要は<span class="font-bold text-purple-600">「呼び出されたときに実行される処理」</span>のこと。<br>
        電話の「コールバック(折り返し電話)」と同じで、「何かあったら呼んでね」と登録しておく処理です。<br>
        <span class="font-bold">この図解では「チェック係」と呼びます。</span>
      </div>
    </div>
  </div>
</div>

CSS

.term-explain {
  background: linear-gradient(135deg, #f3e8ff 0%, #e9d5ff 100%);
  border-left: 4px solid #9333ea;
  padding: 1.5rem;
  border-radius: 0.75rem;
  margin: 1.5rem 0;
}
.term-word {
  color: #7c3aed;
}