ハル式SEOシステム
要件定義書

Phase 4.2: AIサブキーワード生成機能

バージョン: 4.2

作成日: 2025年6月25日

作成者: Gemini

1. エグゼクティブサマリー

本プロジェクトは、月産10,000記事を目指す「ハル式SEOシステム」の構築を目的とする。直近の開発で、システムの抜本的な構造改善であるPhase 4.1: リファクタリングが完了し、システムの安定性、保守性、拡張性が大幅に向上した。次のフェーズとして、Phase 4.2: AIによるサブキーワード自動生成機能の実装に着手する。

2. Phase 4.1 完了報告 (リファクタリング)

2.1. 目的

旧来の単一ファイルに全ての機能が混在していた状態を解消し、各モジュールが単一の責務を持つ、クリーンなアーキテクチャを実現した。

2.2. 達成事項

責務の分離: UI、司令塔(Orchestrator)、専門家(Experts)、処理フロー(Flows)の4層に責務を分離。
単一エントリーポイント: プログラムの起動を `main.py` に集約。
モジュール性向上: 各機能が独立した `.py` ファイルに分割され、拡張が容易に。
PC環境の再現性: `venv`と`requirements.txt`により、どのPCでも開発環境を再現可能に。

3. Phase 4.2: AIサブキーワード生成機能 – 要件定義

3.1. 目的

現在 `ArticleCreationFlow` で手動入力しているサブキーワードを、AIが自動生成する機能に置き換え、記事作成の完全自動化と品質の均一化を図る。

3.2. 技術仕様・実装方針

影響範囲:
- `src/gemini_generator.py`: 新メソッド `generate_sub_keywords` を追加。
- `src/flows/article_creation_flow.py`: 手動入力ループを新メソッド呼び出しに置換。
プロンプト設計:
- 役割: プロのSEOコンサルタント
- 指示: 検索意図を網羅し、多様な観点から12個のサブキーワードを生成。
- 出力形式: Pythonのリスト形式 `[“キーワード1”, “キーワード2”, …]`
エラーハンドリング:
APIエラー時は空リストを返し、フロー側で安全に処理を中断する。

4. システム全体の現状

現在のシステムは以下の情報で管理・実行されています。

# Repository
https://github.com/pipa123/haru-blog-system-phase2

# Setup & Run Commands
1. git clone https://github.com/pipa123/haru-blog-system-phase2.git
2. cd haru-blog-system-phase2
3. python -m venv venv
4. .\\venv\\Scripts\\Activate
5. pip install -r requirements.txt
6. python main.py
                

5. 次回チャットへの引き継ぎ事項

Primary Task: 本要件定義に基づき、AIサブキーワード自動生成機能の実装を開始する。
First Step: `src/gemini_generator.py` に `generate_sub_keywords` メソッドを追加する実装から着手する。

ハル式SEOシステム要件定義書

目次