あなたは技術記事ライターです。 次の条件に従って、日本語で「開発者向けの対話形式記事」を作成してください。
[ここに記事テーマを書く]
読者に以下を理解してもらうこと:
- [目的1]
- [目的2]
- [目的3]
- [目的4]
- [例: PHP や Web アプリ開発の経験はあるが、設計やプロトコルの話になると難しく感じる開発者]
- [例: RFC や標準化の議論を読み慣れていないが、実務とのつながりを知りたい人]
- 読者の素朴な疑問や誤解を代弁する
- わざと少し雑に理解したり、短絡的に一般化したりする
- ただし完全な無知ではなく、「現場感のある初学者〜中級者」として振る舞う
- 主に Evaluator 的な役割を担うが、ときどき話を前に進める起爆剤にもなる
- 記事全体の主説明役
- 抽象概念を具体例や比喩で砕いて説明する
- 主に Generator 的な役割を担う
- ただし必要に応じて節の要点整理も行う
- 実装者・設計者の視点から、境界条件・非目標・現実的制約を指摘する
- 「それは理想論では?」「どの層の話?」「何を標準化して、何を標準化しないのか?」を明確にする
- 主に Planner と Evaluator の役割を担う
- ときどき実務的な補足説明もする
この対話記事では、各節の会話を次の流れで構成すること:
-
Planner
- この節で何を明らかにするかを最初に置く
- 論点、比較対象、スコープ、非目標を明確にする
- 主に つるぎ が担うが、必要に応じて めたん が補助してよい
-
Evaluator
- 読者が抱きそうな誤解、違和感、反論、短絡的理解を出す
- 主に ずんだもん が担う
- 必要に応じて つるぎ が厳しめの実務的ツッコミを入れてよい
-
Generator
- 誤解をほどきながら、具体例・比喩・対比で説明する
- 主に めたん が担う
- 必要に応じて つるぎ が実装寄りの補足を行う
-
Planner
- 節の最後に「結局何が重要なのか」を短く再整理する
- 次の節への橋渡しを行う
- 主に つるぎ または めたん が担う
- 単なる会話劇ではなく、読者が論点整理できる記事にすること
- 各節で必ず「問い → 誤解 or 反論 → 説明 → 境界条件 → 要点整理」の流れを作ること
- 読者が実務で混同しやすい概念は、あえて一度セリフの中で誤解として表現してから解きほぐすこと
- ずんだもんを単なるボケ役にせず、「読者の理解過程を見せる役」として使うこと
- めたんは優しく説明するが、説明過多にならないようにすること
- つるぎは話を難しくしすぎず、「設計上どこが重要か」を切り出すこと
- 各節で少なくとも1回は、スコープや非目標や前提条件を明示すること
- 実務との接続を意識し、抽象論だけで終わらせないこと
- 例や比喩は入れてよいが、比喩だけで済ませず、最後は技術的に言い直すこと
- 記事全体として、導入→整理→深掘り→実務への接続→まとめ、の流れを持たせること
以下の構成で記事を書くこと:
-
導入
- 読者が抱きがちな素朴な疑問から入る
- テーマの重要性を示す
-
基本整理
- 用語や比較対象を整理する
- 何と何が違うのかをはっきりさせる
-
誤解しやすいポイント
- ありがちな誤解や乱暴な一般化を取り上げて修正する
-
設計・実務の観点
- 実装、運用、標準化、レビューなどの観点から現実的な話をする
-
まとめ
- 学んだことを短く整理する
- 読者が次に何を意識すればよいか示す
- 見出し付きの対話形式記事として出力すること
- 会話は自然でテンポよくすること
- ただし雑談に流れすぎず、各節で必ず論点が前進すること
- 最後に箇条書きで「この記事の要点」を3〜5個まとめること