mcpField
F
file-naming

file-naming

github.com/nweii生産性1080 回インストール1 週間前に更新
リポジトリ

file-naming について

ファイルの内容やメタデータを基に、並べ替えやすい名前を提案するエージェント向けスキルです。変更前に計画全体をプレビューし、検証します。

主な機能

  1. 01内容とメタデータの分析
  2. 02文書種別ごとの命名規則
  3. 03保存先と名前の重複検証
  4. 04変更前のプレビューと確認
  5. 05既存ファイルを上書きしない実行

活用シーン

  1. 01領収書、請求書、明細書の整理
  2. 02写真やプロジェクトファイル名の統一
  3. 03名前変更案を確認してからファイルを改名

インストール

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

$npx skills add https://github.com/nweii/agent-stuff --skill file-naming

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

同梱ファイルreferences/tv-episodes.md

詳細

ファイル名の変更

ファイルを分析し、コンテンツの種類とメタデータに基づいて、適切なファイル名を提案します。単一のファイルパス、ファイルパスのリスト、またはフォルダパスを指定してください。

命名規則

取引・定期書類

繰り返し発生する取引(注文、領収書、請求書、予約):

  • 形式:YYYY-MM-DD Category Type - Details.extension
  • 例:2025-06-13 Amazon Order 123-456 - USB Cable.pdf
  • 含める情報:日付、事業者名、注文番号/請求書番号、品目の説明

定期書類(明細書、請求書、フォーム):

  • 形式:YYYY-MM Type - Entity.extension
  • 例:2025-06 Bank Statement - Chase Checking.pdf
  • 例:2023-12 W2 - Acme Corp.pdf

継続中の契約(契約書、ポリシー):

  • 形式:YYYY-MM Type - Entity.extension
  • 例:2025-01 Service Agreement - Internet Provider.pdf

予約・受診:

  • 形式:YYYY-MM-DD Type - Provider/Location.extension
  • 例:2025-06-13 Dental Visit - Dr Johnson.pdf
クリエイティブ・プロジェクトファイル

日付を補足情報として使用(写真、プロジェクト、クリエイティブ作品):

  • 形式:Description - Date.extension または Description - Context Date.extension
  • 例:Vacation Photos - Hawaii 2025.jpg
  • 例:Website Redesign - Draft 2025-06.pdf
  • 例:Company Logo 2025.png

長期的に使うコンテンツ(マニュアル、参考資料):

  • 形式:Type - Name/Description.extension
  • 例:Product Manual - Widget Pro.pdf

主な原則

  • ISO 8601形式の日付:YYYY-MM-DD(特定の日付)または YYYY-MM(月次/年次)
  • 日付の位置:時系列での並べ替えが重要な場合は先頭、文脈を示す場合は末尾
  • 削除するもの:技術的なメタデータ(1080p、WEB-DL)、問題のある文字(:*?"<>|#%&)
  • 維持するもの:一覧性と並べ替えやすさを備えたファイル名

手順

  1. OCR、テキスト抽出、画像分析、ファイル名のパターンを使ってファイルを分析します
  2. 何らかの操作を行う前に、完全な名前変更計画を作成します
  3. 計画を検証します。保存先の名前に対応付けられないファイルが1つでもある場合は、停止して報告し、一部の結果だけで処理を進めないでください
  4. 計画を検証します。保存先の名前が重複するファイルがないことを確認します。重複がある場合は停止して報告してください
  5. プレビュー表「元のファイル名」|「新しいファイル名」を表示します(ファイルが多い場合は最大15件を表示し、分析できなかったファイルがあれば記載します)
  6. 実行前に確認を待ちます
  7. 既存のファイルを上書きしない方法で実行します。実行時に重複が発生した場合は、直ちに停止します

コンテンツが不明瞭な場合は、ファイル名から最善の推測を行い、既存の名前を整理するか、注記を添えて変更せずに残します。

テレビ番組のファイルについては、Plex/メディアマネージャーの命名規則を参照してください:references/tv-episodes.md。

コメント