thematic-analysis

name	thematic-analysis
description	テーマ分析 (Thematic Analysis) - テキストファイル群から質的研究のテーマ分析を行うスキル。対象ディレクトリ内のテキストファイル（.txt, .md, .docx等）に対して、ファイル名へのインデックス付与、文単位でのCSV保存、テーマ抽出、深層構造分析を実行する。「テーマ分析して」「thematic analysis」「質的分析」「テキストを分析して」などのリクエストで使用する。

テーマ分析 (Thematic Analysis)

テキストファイル群から質的研究のテーマ分析を実行する。

処理フロー

0. context.md読み込み → 1. ファイル名インデックス付与 → 2. sentences.csv作成 → 3. テーマ抽出 → 4. 深層構造分析（総括） → 5. themes.md作成

ステップ0: context.mdの読み込み（任意）

対象ディレクトリのルートにcontext.mdがある場合、分析開始前に読み込む。

context.mdの内容例:

• データ収集時の状況・背景
• 分析の目的・研究課題
• 対象者の属性情報
• 収集方法（インタビュー、アンケート等）
• その他、分析に影響する文脈情報

このファイルは分析対象データとしては処理されず（インデックス付与・CSV化されない）、分析者がテーマを解釈する際のコンテキストとして使用する。

ステップ1: ファイル名へのインデックス付与

$SKILL_ROOT/scripts/add_index.pyを実行してファイル名にインデックスを付与。

python "$SKILL_ROOT/scripts/add_index.py" [対象ディレクトリ]

処理内容:

• 対象: .txt, .md, .docx ファイル
• 既にインデックス付き（例: 01_xxx.txt）のファイルはスキップ
• 既存の最大インデックスの次の番号から付与

田中太郎.txt → 01_田中太郎.txt
山田花子.md → 02_山田花子.md

ステップ2: sentences.csv作成

$SKILL_ROOT/scripts/create_csv.pyを実行して文単位のCSVを作成。

python "$SKILL_ROOT/scripts/create_csv.py" [対象ディレクトリ] [出力ファイル名]

分割ルール:

• 句点（。）で区切る
• 改行で区切る
• 見出し行（#や**で始まる）は1単位

CSV形式:

id,content
01-001,最初のファイルの1文目
01-002,最初のファイルの2文目
02-001,2番目のファイルの1文目