mcpField
F
file-organizer

file-organizer

github.com/acaprino生産性9132 回インストール2 日前に更新
リポジトリ

file-organizer について

file-organizerは、個人用ファイルや文書フォルダー、非アクティブなアーカイブを整理するスキルです。変更前の承認と移動ログによる追跡を重視し、アクティブなリポジトリは一般的な整理の対象外とします。

主な機能

  1. 01ファイル種別と容量の分析
  2. 02フォルダー構成の提案
  3. 03重複ファイルの検索と確認
  4. 04変更前の承認
  5. 05移動の記録と日付の保持
  6. 06アクティブなリポジトリの除外

活用シーン

  1. 01散らかったDownloadsフォルダーの整理
  2. 02個人文書のフォルダー構成の計画
  3. 03削除前の重複ファイル確認
  4. 04非アクティブな個人プロジェクトのアーカイブ

インストール

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

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

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

同梱ファイルreferences/organization-guide.mdSKILL.toml

詳細

ファイル整理

個人用／文書フォルダーや、使用していないアーカイブを整理します。一般的なファイル整理では、稼働中のリポジトリを対象外にしてください。ソースの構成、テスト、手順、実行時の生成物は、そのプロジェクト固有の管理と検証の対象です。リポジトリ内に同じような名前のファイルがあっても、ハッシュ値や経過日数だけで削除可能な重複ファイルと判断しないでください。この境界をユーザーに伝え、内容を移動せずに、開発プロセスまたはリポジトリの整理プロセスに引き継いでください。

手順

1. 対象範囲を把握する

開始前に、確認の質問をします。

  • どのディレクトリを整理しますか？
  • 主な問題は何ですか？（ファイルが見つからない、重複、構成がない、全体的に散らかっている）
  • 避けるべきファイルやフォルダーはありますか？（稼働中のプロジェクト、機密データ）
  • どの程度徹底的に整理しますか？（保守的または包括的な整理）

広範囲の再整理では、参考ガイドから整理方針（PARA、Johnny Decimal、GTD、7-Folder）を簡潔に提案します。ユーザーに選んでもらい、決して押し付けないでください。Downloads の整理など、範囲が限定された作業では省略します。

2. 現状を分析する
ls -la [target_directory]
find [target_directory] -type f -exec file {} \; | head -20
du -sh [target_directory]/* | sort -rh | head -20
find [target_directory] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn

合計ファイル数／フォルダー数、種類別の内訳、サイズの分布、日付の範囲、明らかな問題点を要約します。

注意すべきアンチパターン：

  • デスクトップを恒久的なアーカイブとして使っている（目標：デスクトップ上の恒久ファイルをゼロにする）
  • 名前のないフォルダー（New Folder、New Folder (3)）
  • 破綻したバージョン管理（document_FINAL_v2_DEFINITIVE_copy.docx）
  • ダウンロードフォルダーを一度も整理していない（未整理のファイルが数千件ある）
  • 同じファイルが複数の場所に重複している（代わりにショートカットを使う）
3. 整理パターンを特定する

種類別：

  • 文書（PDF、DOCX、TXT）、画像（JPG、PNG、SVG）、動画（MP4、MOV）
  • アーカイブ（ZIP、TAR、DMG）、コード／プロジェクト、スプレッドシート（XLSX、CSV）、プレゼンテーション（PPTX、KEY）

用途別：

  • 仕事用または個人用、進行中またはアーカイブ、プロジェクト固有、参照用、一時用／作業用

日付別：

  • 今年／今月、過去数年、かなり古いもの（アーカイブ候補）

用途に応じた構成：

  • 写真／動画：Year/YYYY-MM_event-location/ に RAW、Edited、Export のサブフォルダーを作成
  • 音楽：Artist/[Year] Album/NN - Track.ext
  • 仕事用プロジェクト：番号付きの接頭辞（01_Brief/、02_Research/、03_Assets/、04_Deliverables/）を使い、WIP と FINAL_APPROVED を分ける
  • 財務／個人文書：ファイル名に有効期限を含め（passport_exp_2030.pdf）、年、種類の順に整理
  • コード：ローカルパスをリモート URL に対応付ける（github.com/username/repo/）

詳しいテンプレートについては、references/organization-guide.md を参照してください。

4. 重複を見つける

依頼された場合：

find [directory] -type f -exec md5 {} \; | sort | uniq -d
find [directory] -type f -printf '%f\n' | sort | uniq -d

重複ファイルの各セットについて、パス、サイズ、日付を示し、どのファイルを残すべきか提案します。削除する前に必ず確認してください。コピーを残す代わりに、ショートカット／エイリアスを使うことを提案します。

5. 整理計画を提案する

変更を加える前に計画を提示します。以下を含めてください。

  • 現状の要約（ファイル数、サイズ、種類別の内訳、見つかった問題）
  • 検出したアンチパターン
  • 提案するフォルダーツリー構成
  • 実施する変更：新しいフォルダーの作成、ファイルの移動、名前の変更、削除
  • 配置についてユーザーの判断が必要なファイル
  • 作業を進める前に明確な承認を求める
6. 整理を実行する

承認を得たら、体系的に整理します。

ルール：

  • 何かを削除する前に必ず確認する
  • 元に戻せるよう、すべての移動を記録する
  • 元の更新日時を保持する
  • ファイル名の競合には適切に対処する
  • 想定外の状況が発生したら、作業を中断して確認する

ファイル名の変更規則（ユーザーが同意した場合のみ。自動で名前を変更しないでください）：

  • ISO 日付：アルファベット順で正しく並べ替えられるよう YYYY-MM-DD を使う
  • 形式：[Date]_[Context]_[Description]_[Version].ext
  • バージョンはゼロ埋めする：v01、v02（マイナー：v01.1）
  • 区切り文字：kebab-case または snake_case（スペースは使わない）
  • すべて小文字にし、ファイル名は 25～30 文字未満にする。残りの情報はフォルダーで補う
  • 連番はゼロ埋めする：001、002（1, 10, 11, 2 のような並び替えを防ぐ）
  • 必要に応じてステータスの接頭辞を付ける：WIP_、DRAFT_、REVIEW_、APPROVED_
  • 次の文字は避ける：< > : " / \ | ? *、アクセント記号、絵文字、先頭のピリオド、Windows の予約名（CON、PRN、AUX、NUL）
  • フルパスが Windows の 260 文字制限に近づいていないか確認する
7. 概要を報告する

整理後、以下を報告してください。

  • 作成したフォルダー、整理したファイル、空けた容量、修正したアンチパターン
  • 新しいフォルダー構造
  • メンテナンススケジュール（以下）
  • 継続的なクリーンアップ用のカスタム bash コマンド

メンテナンススケジュール：

頻度時間タスク
毎週15 minDownloads を空にし、Inbox を空にするまで処理し、最近のファイルが所定の場所にあることを確認する
毎月45 min重複ファイルをスキャンし、バックアップを確認し、完了したプロジェクトをアーカイブする
四半期ごと2 hrsディスク容量を監査し、3 か月以上使われていないプロジェクトをアーカイブし、バックアップの復元をテストする
毎年Half day災害復旧テストを実施し、保持ポリシーを見直し、構造を更新する

コメント

Markdown 対応