| name | article-writer |
| description | テーマからアウトライン生成→文体プロファイル適用→Markdown記事出力を行う記事執筆スキル。 挿絵マーカーの自動挿入、style-analyzerプロファイル参照による文体統一に対応。 「記事を書いて」「ブログ作成」「テーマで記事生成」等のリクエストで発動。 |
| triggers | ["article-writer","記事を書いて","ブログ作成","テーマで記事生成","記事執筆","アウトライン作成","Markdown記事"] |
Article Writer - AI記事執筆エンジン
テーマを入力するだけで、構造化されたMarkdown記事を自動生成します。文体プロファイルによるトーン統一、挿絵マーカーの自動挿入に対応し、一貫性のある高品質な記事を出力します。
ワークフロー
テーマ入力 → アウトライン生成 → スタイル適用 → セクション執筆 → 挿絵マーカー挿入 → 一貫性チェック → Markdown出力
- テーマ分析とアウトライン生成: テーマからセクション構成・見出し・キーポイントを自動設計
- スタイルプロファイル読み込み: YAMLファイルで文体（トーン、語尾、語彙レベル等）を指定可能
- セクションごとのドラフト執筆: アウトラインに沿ってGemini APIで各セクションを生成
- 挿絵マーカーの自動挿入: 図表・画像の挿入位置をHTMLコメントとして自動配置
- 全体の一貫性チェック: 文体・用語の統一性を確認し最終Markdownを出力
Usage
python scripts/article_writer.py --theme "AIエージェントの活用法" --output output/article.md
python scripts/article_writer.py --theme "AIエージェントの活用法" --style style_profile.yaml --output output/article.md
python scripts/article_writer.py --theme "AIエージェントの活用法" --audience "非エンジニアのビジネスパーソン" --style style_profile.yaml
python scripts/article_writer.py --theme "データ分析入門" --word-count 5000 --sections 7
python scripts/article_writer.py --theme "プロジェクト管理" --illustrations none
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等）で実際の画像を生成できます。
| type | 説明 | 推奨スキル |
|---|
| diagram | フローチャート、構成図、UML図 | diagram-generator |
| image | 写真風、イラスト、概念図 | nanobanana |
| chart | グラフ、データ可視化 | data-analyst |
| screenshot | UI画面キャプチャ | screenshot-annotator |
スタイルプロファイル形式
YAMLファイルで文体を指定します（style-analyzerスキルで自動生成可能）。
tone: professional
formality: high
sentence_ending: です・ます
vocabulary_level: general
paragraph_length: medium
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）からフロー図等を生成 |
