feynman

ファインマン

仕組み、例、境界、演習を通じて、1つの技術テーマを教える文書を書いてください。

ルール

• 一貫性のあるテーマを1つ扱ってください。
• トピックが広すぎる場合は、より範囲を絞ったテーマを2〜4個提示し、ユーザーに1つ選んでもらってください。
• 定義ではなく、読者が心当たりのある観察から始めてください。
• 詳細に入る前に、何がわかるのかを伝えてください。
• 各セクションの冒頭で、要点を伝えてから説明してください。
• 用語を名付ける前に、仕組みを説明してください。
• 形式的な説明の前に、平易なメンタルモデルを1文で示してください。
• 各セクションで具体例を1つ使ってください。
• 一般的なルールを示す前に、例を順を追って説明してください。
• たとえを使う場合は、当てはまらなくなる部分を明示してください。
• 未解決の点、複雑な点、議論のある点を明示してください。
• ありがちな誤った結論を防いでください。
• 短い文と一般的な言葉を使ってください。
• 深遠に聞こえても情報を加えない文は削除してください。
• 参考資料、表、チートシート、構文の概要は別の文書にまとめてください。

構成

# [Title: claim or question]

[Opening: 2-4 sentences. Observation from the reader's experience.]

[Promise: what the reader will understand.]

## [Section title: specific claim]

[Point in one sentence.]
[One concrete example, walked through completely.]
[Code, command, prompt, or diagram only when it clarifies the idea.]

## [Next section]

## Putting it together

[Short scenario that uses the sections together.]

## Try it

[One exercise. Under ten minutes.]

[Closing sentence that earns the opening promise.]

範囲を絞る例

"AI agents" is too broad. Pick one:

1. Agent memory: types, mechanics, when to use each
2. Tool calling: loop mechanics and tool design
3. Error handling: failures, recovery, avoiding hangs

仕組みの例

弱い例：「これはRAGを使って、関連するコンテキストを検索します。」

良い例：「RAGは3つの手順で機能します。まず、保存された文書からユーザーの質問に関連する内容を検索します。次に、その内容をプロンプトに貼り付けます。最後に、その情報を使って回答を生成します。名前はこの手順を表しています。検索し、拡張し、生成します。」

確認項目

• 導入で、読者が心当たりのあることを説明している。
• 詳細の前に、何がわかるのかが示されている。
• 用語より先に、仕組みが説明されている。
• 各セクションで、1つの例を使って1つの要点を教えている。
• ありがちな誤った結論を防いでいる。
• たとえの限界が明示されている。
• 境界となる点が明示されている。
• Putting it together がある。
• 演習がある。