Article Writer - AI記事執筆エンジン

テーマを入力するだけで、構造化されたMarkdown記事を自動生成します。文体プロファイルによるトーン統一、挿絵マーカーの自動挿入に対応し、一貫性のある高品質な記事を出力します。

ワークフロー

テーマ入力 → アウトライン生成 → スタイル適用 → セクション執筆 → 挿絵マーカー挿入 → 一貫性チェック → Markdown出力

1. テーマ分析とアウトライン生成: テーマからセクション構成・見出し・キーポイントを自動設計
2. スタイルプロファイル読み込み: YAMLファイルで文体（トーン、語尾、語彙レベル等）を指定可能
3. セクションごとのドラフト執筆: アウトラインに沿ってGemini APIで各セクションを生成
4. 挿絵マーカーの自動挿入: 図表・画像の挿入位置をHTMLコメントとして自動配置
5. 全体の一貫性チェック: 文体・用語の統一性を確認し最終Markdownを出力

Usage

# Basic article generation
python scripts/article_writer.py --theme "AIエージェントの活用法" --output output/article.md

# With style profile
python scripts/article_writer.py --theme "AIエージェントの活用法" --style style_profile.yaml --output output/article.md

# With target audience
python scripts/article_writer.py --theme "AIエージェントの活用法" --audience "非エンジニアのビジネスパーソン" --style style_profile.yaml

# Specify word count and section count
python scripts/article_writer.py --theme "データ分析入門" --word-count 5000 --sections 7

# Disable illustration markers
python scripts/article_writer.py --theme "プロジェクト管理" --illustrations none

# Test mode (no API call)
python scripts/article_writer.py --test

Parameters

Parameter	Required	Default	Description
--theme	Yes	-	記事のテーマ・トピック
--style	No	-	文体プロファイルYAMLファイルのパス
--audience	No	-	想定読者（例: "非エンジニアのビジネスパーソン"）
--output	No	auto	出力ファイルパス（デフォルト: output/article_{timestamp}.md）
--word-count	No	3000	目標文字数
--sections	No	auto	セクション数（autoの場合テーマから自動決定）
--illustrations	No	auto	挿絵マーカー: auto（自動挿入）/ manual（位置のみ）/ none（なし）
--test	No	false	テストモード（API呼び出しなしでサンプル記事を生成）

挿絵マーカー形式

記事中に以下のHTMLコメント形式で挿絵の挿入位置を示します。後続のスキル（nanobanana, diagram-generator等）で実際の画像を生成できます。

<!-- illustration: type=diagram description="フロー図: AIエージェントの処理手順" -->

<!-- illustration: type=image description="モダンなオフィスでAIを使う人" -->

type	説明	推奨スキル
diagram	フローチャート、構成図、UML図	diagram-generator
image	写真風、イラスト、概念図	nanobanana
chart	グラフ、データ可視化	data-analyst
screenshot	UI画面キャプチャ	screenshot-annotator

スタイルプロファイル形式

YAMLファイルで文体を指定します（style-analyzerスキルで自動生成可能）。

tone: professional        # professional / casual / academic / friendly
formality: high            # high / medium / low
sentence_ending: です・ます  # です・ます / だ・である / 混合
vocabulary_level: general   # general / technical / simple
paragraph_length: medium    # short / medium / long
use_examples: true
use_metaphors: false
target_audience: "ビジネスパーソン"
brand_voice: "信頼感があり、分かりやすい"
avoid_words:
  - "要するに"
  - "ぶっちゃけ"
preferred_expressions:
  - "具体的には"
  - "例えば"

出力形式

Markdown形式の記事ファイル。以下の構成で出力されます。

# 記事タイトル

> リード文（記事の要約・導入）

## 目次

- [セクション1](#セクション1)
- [セクション2](#セクション2)
- ...

## セクション1

本文テキスト...

<!-- illustration: type=diagram description="..." -->

## セクション2

本文テキスト...

<!-- illustration: type=image description="..." -->

## まとめ

結論テキスト...

並列実行

複数テーマの記事を同時に生成する場合、エージェントを複数起動して並列処理できます。

# 複数テーマを並列実行
python scripts/article_writer.py --theme "AI活用法" --output output/ai.md &
python scripts/article_writer.py --theme "DX推進" --output output/dx.md &
wait

Requirements

• API Key: GEMINI_API_KEY または GOOGLE_API_KEY を環境変数に設定
• Python packages: google-genai, pyyaml, python-dotenv

Related Skills

スキル	連携内容
style-analyzer	参考文章から文体プロファイルを自動生成 → --style に渡す
proofreading-agent	生成記事の校正・推敲
fact-checker	記事内の事実関係を検証
nanobanana	挿絵マーカー（type=image）から実際の画像を生成
diagram-generator	挿絵マーカー（type=diagram）からフロー図等を生成