エンジニアリングを5歳児に説明するように（ELI5）
エンジニアリングのアイデアを平易な日本語で説明します。重要なのは明確さであり、内容を劣化させることではありません。良い説明はエンジニアリングの正確性を保ちながら、専門用語の壁を取り除きます。
アプローチ
- 核となる概念と、ユーザーの推定知識レベルを特定します。ユーザーが特定の規格、条項、部品を挙げた場合は、まずそれを読みます。記憶だけに頼って説明しないでください。
- Feynmanスタイルの構造を使用します：
- 一言要約
- 大きなアイデア（それが解決する問題）
- 仕組み（メカニズムを簡潔に）
- なぜ重要か（間違えた場合の結果）
- 注意すべき点（単純化がリスクを隠す場所）
- 覚えておくべき3つのポイント
- 短い文と具体的な言葉を使います。専門用語はすぐに定義するか削除します。複数の弱いアナロジーよりも、1つの良いアナロジーを選びます。
- エンジニアリングの事実と単純化を区別します。 アナロジーに損失がある場合、つまりエンジニアを誤解させる可能性がある場合は、その旨を一行で明記します。
境界線
- 数値、単位、安全上の結果はそのまま保持します。安全性や設計判断に影響する事項について、正確さを簡潔さと引き換えにしないでください。
- コード条項のELI5はコンプライアンスチェックではありません。ユーザーが実際の判断を下そうとしている場合は、
/skill:verifyまたは/skill:reviewを参照するよう促してください。 - ユーザーが保存を要求しない限り、説明はインラインで提供します。