file-intel

File Intel — Gemini ファイルプロセッサー

フォルダー内のファイルに対して scripts/process_files_with_gemini.py を実行し、Obsidian で使える要約を作成します。

ステップ 1：フォルダーを取得する

AskUserQuestion を使用します。

Question: "Which folder should I process?"
Options:
1. "This vault's inbox/" — process the inbox folder
2. "Custom path" — user specifies a folder

ユーザーがオプション 2 を選択した場合は、「Other」入力欄にパスを入力します。

ステップ 2：スクリプトを実行する

vault のルートから Bash で実行します。

python scripts/process_files_with_gemini.py <folder_path>

• inbox/ の場合：python scripts/process_files_with_gemini.py inbox/
• カスタムパスの場合：引数として渡します

実行中のターミナル出力を表示し、処理中のファイルをユーザーがリアルタイムで確認できるようにします。

ステップ 3：出力を開く

スクリプトの実行完了後、出力フォルダーを開きます。

open "outputs/file_summaries/YYYY-MM-DD/"

YYYY-MM-DD は、スクリプト出力に表示された今日の日付に置き換えます。

ステップ 4：結果を報告する

ユーザーに以下を伝えます。

• 処理したファイル数
• 要約の保存先
• すべての内容をまとめた単一ファイルのダイジェストとして MASTER_SUMMARY.md を案内する
• 「Claude Code を開いて、次のように伝えてください：inbox/ 内のすべてを適切なフォルダーに振り分けて」

注意事項

• 対応形式：PDF、PPTX、XLSX、DOCX、CSV、JSON、XML、MD、TXT、PY、JS、HTML、CSS
• 出力先：outputs/file_summaries/YYYY-MM-DD/
• 各ファイルにそれぞれ *_summary.md が作成されます
• MASTER_SUMMARY.md はすべての要約を 1 つのダイジェストにまとめます
• 要約は文脈を考慮します。納品物（請求書、レポート）と参照ファイル（コード、設定ファイル）では、異なる形式になります

---

注意すべき点

• 文字コードの判定はベストエフォートであり、確定的ではありません： Windows-1252 または Latin-1 で保存されたファイルは、エラーが明確に表示されず、文字化けした UTF-8 として処理される場合があります。出所不明のファイルを一括処理した場合は、最初の要約を抜き取り確認してください。アクセント付き文字が文字化けして表示される場合は、元ファイルの文字コードが誤判定されています。
• パスワード保護または暗号化された PDF の要約は空になります： Gemini はロックされた PDF からテキストを抽出できませんが、スクリプトは失敗として報告しません。各 *_summary.md のファイルサイズを確認してください。約 200 バイト未満のものは要注意です。
• スキャン画像の PDF は OCR の信頼度に左右されます： 低 DPI のスキャン、手書き、ページの回転があると、正直に「読み取れませんでした」と出力する代わりに、幻覚を含む要約が作成されることがあります。後続の判断に使用する前に、スキャン文書を原本と照合してください。
• 複数のシートを含む XLSX ファイルでは、アクティブなシートのみが要約されます： プロセッサーはブックを開いたときに表示されるシートを読み込み、その他のシートは通知なしにスキップします。複数シートの財務資料は、ファイルを分割するか、一部のみが処理されることを想定してください。
• MASTER_SUMMARY.md はファイル数に比例して大きくなり、大きなフォルダーではコンテキスト上限を超えます： inbox/ に 200 個のファイルがある場合、別の LLM 呼び出しに入力すると切り詰められるほど大きなダイジェストが作成されます。約 50 個を超えるファイルを一括処理する場合は、マスターではなくファイルごとの要約を使用してください。
• 同じフォルダーを再実行すると、新しい YYYY-MM-DD/ サブディレクトリに出力されます： 同じ日の 2 回の実行では互いの出力が上書きされます。異なる日の実行では、相互参照のない重複が作成されます。再処理する前に、以前の出力を削除するか、アーカイブしてください。