ブログ記事執筆スキル

ブログ記事を効率的に執筆するためのワークフロー。

使用タイミング

• •新しいブログ記事を書くとき
• •記事の構成を相談したいとき

ワークフロー

Phase 1: 企画（最初に必ず実施）

1. •

   一言サマリーを決める

   • •「この記事を一言で言うと？」を明確にする
   • •例: 「HugoからAstroに移行した理由と感想」
2. •

   ターゲット読者を決める

   • •誰に向けて書くか明確にする
   • •例: 「同じ移行を検討している人」「自分の振り返り用」
3. •

   記事の性質を決める

   • •ポエム系: 気持ち・動機・哲学を中心
   • •技術系: 比較・選定理由・手順を中心
   • •ハイブリッド: 冒頭で動機を簡潔に → 本題へ

Phase 2: 構成（見出しスケルトン）

本文を書く前に、見出しだけのスケルトンを作成する。

## 導入（何の記事か）
## 背景・動機（なぜ）
## 本題（詳細）
### サブセクション1
### サブセクション2
## まとめ・所感
## 参考

確認ポイント:

• •見出しだけで内容が伝わるか
• •論理的な流れになっているか
• •書きたいことが全て含まれているか

Phase 3: 深掘り（インタビュー形式）

構成が決まったら、各セクションの内容を深掘りする。

自問すべき質問リスト:

• •なぜこれを選んだ？
• •他の選択肢を捨てた理由は？
• •一番の決め手は？
• •ハマった点は？
• •結局どうだった？

Phase 4: 執筆

見出しスケルトンに沿って本文を埋める。

注意点:

• •各セクションは独立して読めるように
• •一つのセクションに複数の話題を混ぜない
• •迷ったら「別記事にできるか？」を考える

Phase 5: レビュー

1. •

   ファクトチェック

   • •コード例は実際の実装と一致しているか
   • •リンクは正しいか
   • •技術的な説明に誤りはないか
2. •

   読み返し

   • •導入で何の記事かわかるか
   • •論理の飛躍はないか
   • •冗長な部分はないか

アンチパターン

• •書きながら構成を変える → 見出しを先に決める
• •複数の話題を一つの記事に詰め込む → 別記事にする
• •ターゲットを決めずに書き始める → Phase 1を省略しない
• •書いてから削る → 最初から絞る

出力先

content/posts/{category}/{slug}.md