/start-14-1

description: "Lesson command"
chapter: "courses/aiagent/lesson03-core/module14-article-writing/chapter.yaml"
category: "lesson"
duration: "25分"
prerequisites: []
level: "beginner"
tags: ["article", "planning"]
nonInteractiveMode: deferred

🎓 Lesson 14-1: 記事企画 - テーマ決定・アウトライン生成

📍 このセッションでやること

**Lesson 14-1: 記事企画 - テーマ決定・アウトライン生成** へようこそ！

| 項目 | 内容 | |------|------| | ゴール | 記事のテーマを決定し、ターゲット読者を設定し、記事のアウトラインを生成する | | 所要時間 | 約25分 | | 使うスキル | article-writer | | 前提条件 | Gemini APIキー設定済み | | 教材ページ | [Module 14: 記事作成](https://ai-agent.camp/ja/course/module-14) を並行参照 |

**このセッションの流れ:** 1. 記事のテーマとターゲット読者を設定する 2. article-writerスキルでアウトラインを自動生成する 3. アウトラインをレビューし、構成を調整する

セッション終了時には、記事テーマ・ターゲット読者・アウトライン（見出し構成）が確定しています。

> **💡 ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。ツールによって応答が途中で止まることがありますが、故障ではありません。

---

🎯 準備チェック

まずは準備が整っているか確認しましょう。

**AskQuestionの設定:**

{
  "title": "🎯 セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "view_html", "label": "先に教材ページを見たい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (check_prereq → 前提条件の確認を実行) (view_html → 教材ページのパスを案内) (different_lesson → モジュール一覧を表示)

---

🚀 Step 1: テーマとターゲット読者の設定

Codex では通常チャットで選択肢を提示しながらで記事タイプを選びます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 1: 記事タイプを選ぶ",
  "questions": [{
    "id": "article_type",
    "prompt": "どのタイプの記事を書きますか？",
    "options": [
      {"id": "blog", "label": "ブログ記事（カジュアル・読みやすさ重視）"},
      {"id": "explainer", "label": "解説記事（概念・仕組みの説明）"},
      {"id": "technical", "label": "技術記事（手順・実装の詳細）"},
      {"id": "free_theme", "label": "自由テーマ（自分で指定する）"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

以下の条件で記事のテーマとターゲット読者を設定してください。

記事タイプ: ブログ記事
テーマ候補: AIツールを使った業務効率化
ターゲット読者: 30〜40代のビジネスパーソン、ITリテラシーは中程度

以下を出力してください：
1. 記事タイトル案（3候補）
2. ターゲット読者のペルソナ（年齢、職種、課題、ゴール）
3. 記事の目的（読者にどんな行動を促すか）
4. 想定文字数
5. キーワード候補（SEO用、3〜5個）

結果をoutput/article-14-1-theme.mdに保存してください。

**期待される結果**: テーマ候補、ターゲットペルソナ、記事の目的が整理され、Markdownファイルとして保存されます。

---

🚀 Step 2: article-writerスキルでアウトライン生成

Codex では通常チャットで選択肢を提示しながらで「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 2: アウトラインを生成する",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

article-writerスキルを使って、以下のテーマで記事のアウトラインを生成してください。

テーマ: AIツールを使った業務効率化
ターゲット: 30〜40代のビジネスパーソン
記事タイプ: ブログ記事
想定文字数: 3000〜4000字

以下を含むアウトラインを作成してください：
1. 導入（フック + 記事の概要）
2. 本文の見出し構成（H2/H3レベル）
3. 各セクションの要点メモ（2〜3行）
4. 挿絵候補の位置（<!-- illustration: type=image/diagram, description="..." -->形式）
5. まとめ・CTA

結果をoutput/article-14-1-outline.mdに保存してください。

**期待される結果**: 見出し構成・各セクションの要点・挿絵マーカー付きのアウトラインが生成されます。

---

🚀 Step 3: アウトラインのレビューと調整

Codex では通常チャットで選択肢を提示しながらで「このまま進める / 例だけ確認 / スキップ」を選べます。

**AskQuestionの設定例:**

{
  "title": "🚀 Step 3: アウトラインをレビュー・調整する",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

**選択後の案内（例）**: 入力内容:

output/article-14-1-outline.mdのアウトラインをレビューしてください。

以下の観点でフィードバックをお願いします：
1. 論理的な流れ: 各セクションのつながりは自然か？
2. 網羅性: ターゲット読者の疑問に答えられているか？
3. 読みやすさ: セクションの長さのバランスは適切か？
4. 挿絵配置: 図表や画像の挿入箇所は効果的か？

改善が必要な箇所があれば修正版を提案し、
最終版をoutput/article-14-1-outline-final.mdに保存してください。

**期待される結果**: アウトラインのレビュー結果と改善提案が示され、最終版アウトラインが保存されます。

---

⚠️ よくあるトラブルと解決方法

Codex では通常チャットで選択肢を提示しながらでトラブル内容を選んでもらい、押すだけで案内します。

**AskQuestionの設定例:**

{
  "title": "トラブル内容を選択",
  "questions": [{
    "id": "trouble",
    "prompt": "当てはまる内容を1つ選んでください",
    "options": [
      {"id": "trouble_1", "label": "テーマが決まらない・広すぎる"},
      {"id": "trouble_2", "label": "アウトラインが浅い・具体性がない"},
      {"id": "trouble_3", "label": "挿絵マーカーが生成されない"},
      {"id": "trouble_4", "label": "ファイルが保存されない"}
    ]
  }]
}

トラブル1: 「テーマが決まらない・広すぎる」

**原因**: テーマの粒度が大きすぎて焦点が定まらない **解決プロンプト**:

テーマを絞り込むために、以下の3つの質問に答えてください：
1. 読者が一番知りたいことは何か？（1つだけ）
2. この記事を読んだ後、読者に何をしてほしいか？
3. 類似記事との差別化ポイントは？
これらをもとにテーマを再設定してください。

トラブル2: 「アウトラインが浅い・具体性がない」

**原因**: テーマやターゲットの情報が不足している **解決プロンプト**:

アウトラインをより具体的にするために、各セクションに以下を追加してください：
- 具体的な事例やデータ（1つ以上）
- 読者への問いかけ（1つ）
- アクションアイテム（1つ）

トラブル3: 「挿絵マーカーが生成されない」

**原因**: プロンプトで挿絵マーカー形式を指定していない **解決プロンプト**:

アウトラインに挿絵マーカーを追加してください。
形式: <!-- illustration: type=image|diagram, description="説明文" -->
各H2セクションに最低1つの挿絵マーカーを配置してください。

トラブル4: 「ファイルが保存されない」

**原因**: outputディレクトリが存在しない **解決プロンプト**:

outputディレクトリが存在するか確認し、なければ作成してください。
mkdir -p ~/ai-agent-camp/output

---

✅ チェックポイント

• [ ] 記事のテーマとタイトル案を決定した
• [ ] ターゲット読者のペルソナを設定した
• [ ] article-writerスキルでアウトラインを生成できた
• [ ] アウトラインをレビューし、最終版をoutput/に保存した

---

📋 成果物プレビュー

期待される出力

📁 output/
└── article-14-1-*.md  (記事ドキュメント)

確認コマンド

# ファイルの存在とサイズを確認
ls -lh output/article-14-1-*.md

# 冒頭を確認（最初の30行）
head -30 output/article-14-1-*.md

> 💡 全文を確認: `cat output/article-14-1-*.md` で全文表示できます

---

✅ 完了チェック

以下をCodexのチャットに入力して、完了状況を確認してください:

# 完了確認: output/ フォルダに期待される出力ファイルが生成されているか確認してください。

**期待される結果**: 完了/未完の判定と不足項目が表示されます。

---

➡️ 次のステップ

これでこのセクションは完了です。次のセクションを始めるか、新しいウィンドウを開いて、新しいセクションを開始してください。

Codex では通常チャットで選択肢を提示しながらで選べます。

**AskQuestionの設定例:**

{
  "title": "次のステップを選択",
  "questions": [{
    "id": "next_step",
    "prompt": "次に進む操作を選んでください",
    "options": [
      {"id": "next_auto", "label": "次のセクションを開始（/next_lesson）"},
      {"id": "next_window", "label": "新しいウィンドウで開始（/start-14-2）"},
      {"id": "finish", "label": "ここで終了する"}
    ]
  }]
}

**選択後の案内（例）**:

• next_auto → /next_