# メールチェックスキル

## 説明
複数のGmail/IMAPアカウントを定期的にチェックし、ベイズフィルタで重要度分類を行うOpenClawスキルです。セキュアな認証管理と自律的なメール監視を実現します。

## トリガー
- "メールチェックして"
- "新着メールを確認して"
- "メールの設定をしたい"
- "ベイズフィルタを学習させて"
- "メールアカウントを追加して"

## 前提条件
1. **IMAP対応メールアカウント**（Gmailの場合はIMAP有効化とアプリパスワード推奨）
2. **Bunランタイム**（TypeScript実行環境）
3. **必要な権限**：ファイルシステムへの書き込み権限、ネットワーク接続

## 使用方法

### 初期設定
```
ユーザー: 「メールチェックの設定をしたい」
エージェント: 認証情報の設定ガイドを表示し、セットアップスクリプトを実行
```

### 定期チェック
```
ユーザー: 「メールチェックして」
エージェント: 全アカウントをチェックし、重要メールを要約して報告
```

### 学習モード
```
ユーザー: 「ベイズフィルタを学習させて」
エージェント: 過去のメールから分類器を学習、精度向上
```

## 機能
1. **複数アカウント対応**: Gmail、Outlook、その他IMAP対応サービス
2. **ベイズフィルタ分類**: 重要/普通/スパム/ニュースレターの自動分類
3. **セキュア認証管理**: 環境変数/キーチェーンによる安全な認証情報保存
4. **定期自動チェック**: cron連携による自律的な監視
5. **スマート通知**: 重要度に応じた通知方法の切り替え
6. **学習機能**: ユーザーのフィードバックによる分類精度向上

## ファイル構成
```
mail-checker/
├── SKILL.md              # このファイル
├── scripts/
│   ├── setup.ts          # 初期設定スクリプト
│   ├── check.ts          # メールチェック実行
│   └── train.ts          # ベイズフィルタ学習
├── references/
│   ├── gmail-api-setup.md # Gmail API設定ガイド
│   └── security-guide.md  # セキュリティガイド
├── config/
│   └── schema.ts         # 設定スキーマ定義
└── package.json          # 依存関係
```

## セキュリティ考慮事項
- 認証情報は環境変数または暗号化ファイルで管理
- IMAP接続はTLS 1.2以上を強制
- ログにセンシティブ情報を含めない
- 最小権限の原則に従う

## 依存関係
- `imapflow`: モダンなIMAPクライアント
- `mailparser`: メールパーシング
- `natural`: ベイズ分類器
- `dotenv`: 環境変数管理
- `zod`: 設定バリデーション

## 開発ステータス
- **フェーズ**: 1/4（基盤構築中）
- **最終更新**: 2026-04-11
- **バージョン**: 0.1.0

## 注意事項
- ベータ版のため、重要なメールの見落としに注意
- 定期的なバックアップを推奨
- 分類精度は学習データに依存