mcpField
F
file-organizer

file-organizer

github.com/crazynomad生産性27174 回インストール13 週間前に更新
リポジトリ

file-organizer について

file-organizer は、ダウンロードファイルやオフィス文書を整理する macOS 向けスキルです。スマートフォルダを使う手動モードと自動分類を備え、除外設定でプロジェクトファイルを保護します。

主な機能

  1. 01macOS スマートフォルダの手動作成
  2. 02ファイルの自動スキャンと分類
  3. 03スクリーンショットの月別整理
  4. 04大容量ファイルの検出
  5. 05プロジェクトやシステムディレクトリの除外

活用シーン

  1. 01散らかったダウンロードフォルダの整理
  2. 02スクリーンショットの月別アーカイブ
  3. 03ディスク整理前の重要ファイルの分類
  4. 04容量を多く使うファイルの検出

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crazynomad/skills --skill file-organizer

インストール後、Claude Code で/file-organizerを入力して読み込まれたか確認します。

同梱ファイルscripts/file_organizer.py

詳細

File Organizer - Mac スマートファイル整理アシスタント

ダウンロードフォルダに散らばったオフィス文書の整理を支援します。手動整理（スマートフォルダ）と自動整理の2つのモードに対応し、disk-cleaner と連携して重要なファイルを保護します。

使用するタイミング

次のような場合にこのスキルを使用します：

  • パソコン上のファイルを整理したい
  • ダウンロードフォルダが散らかっていて整理したい
  • ディスクをクリーンアップする前に重要なファイルを整理しておきたい
  • スクリーンショットが多すぎるので分類したい
  • 容量を占めている大きなファイルを見つけたい

機能

  • 📥 デフォルトでダウンロードフォルダを整理 - 他のディレクトリを誤って操作するのを防ぎます
  • 🖐️ 手動モード - macOS のスマートフォルダを作成し、ユーザー自身が整理します
  • 🤖 自動モード - ファイルを自動でスキャンして分類します
  • 📸 スクリーンショット整理 - 月ごとにスクリーンショットを分類します
  • 💾 大きなファイルの発見 - 用途が明確なファイル（PDF、PPT、動画など）のみを表示します
  • 🔒 ホワイトリスト機構 - コードディレクトリを除外し、プロジェクトのファイルを保護します

ファイルの分類

オフィス文書に特化し、コードファイルを誤って移動するのを防ぎます：

分類拡張子
📊 プレゼンテーション.ppt, .pptx, .key
📝 ドキュメント.doc, .docx, .pages, .rtf
📈 表計算.xls, .xlsx, .numbers, .csv
📄 PDF.pdf
🖼️ 画像.jpg, .png, .gif, .webp, .heic
🎬 動画.mp4, .mov, .avi, .mkv
🎵 音声.mp3, .wav, .flac, .m4a
📦 圧縮ファイル.zip, .rar, .7z, .dmg
📚 電子書籍.epub, .mobi, .azw3

除外されるディレクトリ

Mole と同様のホワイトリスト機構で、次を自動的に除外します：

  • コードディレクトリ: .git, node_modules, venv, __pycache__
  • システムディレクトリ: Library, .Trash
  • IDE 設定: .idea, .vscode
  • ビルド成果物: build, dist, DerivedData

使用方法

手動モード（スマートフォルダの作成）
# 默认整理下载文件夹
python scripts/file_organizer.py --manual

# 整理文档文件夹
python scripts/file_organizer.py --manual --scope documents

# 整理整个用户目录
python scripts/file_organizer.py --manual --scope home
自動モード
# 自动整理下载文件夹
python scripts/file_organizer.py --auto

# 预览模式（不实际移动）
python scripts/file_organizer.py --auto --dry-run

# 只整理最近 30 天的文件
python scripts/file_organizer.py --auto --days 30
スクリーンショット整理
# 查看截图
python scripts/file_organizer.py --screenshots

# 自动整理截图（按月份）
python scripts/file_organizer.py --screenshots --auto
大きなファイルの発見
# 查找大于 100MB 的文件
python scripts/file_organizer.py --large-files

# 查找大于 500MB 的文件
python scripts/file_organizer.py --large-files --min-size 500
状態の確認
python scripts/file_organizer.py --status

出力構造

手動モード
~/Desktop/待整理/
├── 📊 演示文稿.savedSearch
├── 📝 文档.savedSearch
├── 📈 表格.savedSearch
├── 📄 PDF.savedSearch
├── 🖼️ 图片.savedSearch
├── 🎬 视频.savedSearch
├── 🎵 音频.savedSearch
├── 📦 压缩包.savedSearch
├── 📚 电子书.savedSearch
└── 💾 大文件 (>100MB).savedSearch
自動モード
~/Desktop/已整理文件-20240125/
├── 演示文稿/
├── 文档/
├── 表格/
├── PDF/
├── 图片/
├── 视频/
├── 音频/
├── 压缩包/
└── 电子书/

disk-cleaner との連携

自動モードで整理した後のフォルダパスは自動的に ~/.config/mole/whitelist.txt に書き込まれ、これらのファイルが disk-cleaner によってクリーンアップされないようにします。

依存関係

  • macOS（Spotlight とスマートフォルダ機能を使用）
  • Python 3.8+

クレジット

  • disk-cleaner と組み合わせて使用します
  • macOS のスマートフォルダ機能に着想を得ています

コメント

Markdown 対応