eli5

平易な言葉を使うためのスタイルガイド

• **該当しないもの：**製品の紹介文やドキュメント（ghostwriterを使用）、またはスライド資料（presentation-creatorを使用）。

依頼された説明にはこのスタイルを使います。ユーザーが継続的なモードを求めた場合に限り、その後の返信でもこのスタイルを維持します。ELI5の依頼が1回あっただけでは、セッション全体の設定は変わりません。

• 識別子、パス、コマンド、エラー、数値、引用された原文はそのまま保持します。それらの周辺で説明します。
• 過度に矮小化する表現は避けます。「単に」「明らかに」「ただ」「簡単に」「もちろん」「ご存じのとおり」などは使いません。
• 作成する文章では em ダッシュを使いません。前後にスペースを入れたハイフンで代用することも避けます。宣伝文句や、ほかの機械的な言い回しについては、コレクション内で唯一のリストである ghostwriter/references/tells.md を参照します。文字どおりの技術用語や引用では、そのまま使います。
• たとえは、仕組みを明確にする場合に限って使います。説明に影響する場合は、たとえの限界も示します。説明が伝わらなかった場合は、同じたとえを長くするのではなく、別の切り口で説明します。
• まず説明または結果を示します。読者が行動する必要がある場合に限り、次のアクションを含めます。エージェントがすでに実行を許可されている作業を、ユーザーに割り当ててはいけません。

説明そのものだけを返します。モードを有効にしたという告知、固定の文数、必須の要約、送信前チェックリストは不要です。

形式を選ぶ

基本は文章です。ユーザーが形式を指定した場合、または文章では内容の構造が伝わりにくい場合は、次の段階に進みます。各段階では作成と確認のコストが増えるため、内容を伝えられる最も低い段階を選びます。

形式	使用する場面	コスト
通常の文章	ほとんどの回答	なし
制御された英語	ユーザーがSTE100または「Simplified Technical English」を指定した場合、あるいは英語を母語としない読者が従う手順や複雑な仕組みを説明する場合	なし
図	部品とそのつながり、時間の経過に沿った流れ、状態、データ経路を示す場合	低
HTMLページ	入力を変えて結果を見ることで理解できる場合、または複数の関連ビューが必要なトピックの場合	中
解説動画	ユーザーが動画を求めた場合、またはアルゴリズムの段階的な処理や曲線の変化など、動きが中心となる概念の場合	高：レンダリング、ナレーション、レビュー

ユーザーが形式を指定した場合はそれに従います。文章に切り替えるよう説得してはいけません。自分で形式を選ぶ場合、質問せずに図より先の段階へ進んではいけません。次の段階が明らかに役立つ場合に限り、1行で提案します。

「80% STE100」「soft STE100」などは、完全な仕様ではなく、references/formats.md にある緩和プロファイルを意味します。図、HTML、動画の作成方法（ツールの選択、ナレーションのキー、レビューステップ）は同じファイルに記載されています。通常の文章以外の形式を作る前に、そのファイルを読み込みます。

対象範囲

この設定は、アシスタントが作成する文章と説明に適用されます。製品の紹介文、技術ドキュメント、READMEの構成にはghostwriterを、PR本文にはpr-creatorを、スライド資料にはpresentation-creatorを使用します。データチャートについては、インストール済みのdatavizスキルがある場合はそれを使用します。

メンテナンス

evals/evals.json には、このスキルの変更に関する動作シナリオとルーティングシナリオが含まれています。説明中にこのファイルを読み込まないでください。