imap-mailbox-cleanup は何をしますか？
Hybrid CLI + Claude Code Skill for IONOS IMAP mailbox triage. Dry-run by default, audit-logged, soft-delete.
概要
このスキルは、IONOS IMAP メールボックス を安全に整理するためのものです。デフォルトではドライランモードで動作し、実際のメールには影響を与えません。すべての操作は監査ログに記録され、メールはソフトデリートされるため、誤って削除しても復元可能です。
前提条件
- IONOS の IMAP メールアカウント
imapfilterがインストールされていることjqがインストールされていること（監査ログの整形に使用）
インストール
# imapfilter のインストール（macOS）
brew install imapfilter
# imapfilter のインストール（Debian/Ubuntu）
sudo apt-get install imapfilter
設定
config.sh ファイルを作成し、以下の変数を設定します。
# config.sh
IMAP_SERVER="imap.ionos.com"
IMAP_USER="[email protected]"
IMAP_PASS="your-password"
使用方法
ドライランの実行（安全）
./mailbox-cleanup.sh --dry-run
実際の整理を実行
./mailbox-cleanup.sh
監査ログの確認
cat audit.log | jq
仕組み
imapfilterを使用して、指定された条件（一定期間経過したメール、既読メールなど）に一致するメッセージを検索します。- デフォルトではドライランモードで実行され、実際の削除は行われません。
- 実行時には、操作内容が
audit.logに JSON 形式で記録されます。 - 実際の削除が行われる場合も、メールはサーバー上で「削除済み」とマークされるだけで、実際には保持されます（ソフトデリート）。
Claude Code との連携
このスキルは Claude Code のスキルとして設計されており、自然言語の指示からメールボックスの整理を実行できます。
例: 「30日以上経過したニュースレターをドライランで確認して」
Claude Code は以下の手順を実行します：
config.shの設定を確認./mailbox-cleanup.sh --dry-runを実行audit.logの内容を読み取り、結果をユーザーに報告- ユーザーの確認後、実際の整理を実行
注意事項
- このスキルは IONOS の IMAP サーバー 向けに最適化されています。他のプロバイダーでも使用できますが、設定を適宜変更してください。
- ドライランモードを必ず先に実行し、何が行われるかを確認してから実際の操作を行ってください。
- 監査ログは定期的にバックアップしてください。
ライセンス
MIT