file-naming について
ファイルの内容やメタデータを基に、並べ替えやすい名前を提案するエージェント向けスキルです。変更前に計画全体をプレビューし、検証します。
主な機能
- 01内容とメタデータの分析
- 02文書種別ごとの命名規則
- 03保存先と名前の重複検証
- 04変更前のプレビューと確認
- 05既存ファイルを上書きしない実行
活用シーン
- 01領収書、請求書、明細書の整理
- 02写真やプロジェクトファイル名の統一
- 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)、問題のある文字(
:*?"<>|#%&) - 維持するもの:一覧性と並べ替えやすさを備えたファイル名
手順
- OCR、テキスト抽出、画像分析、ファイル名のパターンを使ってファイルを分析します
- 何らかの操作を行う前に、完全な名前変更計画を作成します
- 計画を検証します。保存先の名前に対応付けられないファイルが1つでもある場合は、停止して報告し、一部の結果だけで処理を進めないでください
- 計画を検証します。保存先の名前が重複するファイルがないことを確認します。重複がある場合は停止して報告してください
- プレビュー表「元のファイル名」|「新しいファイル名」を表示します(ファイルが多い場合は最大15件を表示し、分析できなかったファイルがあれば記載します)
- 実行前に確認を待ちます
- 既存のファイルを上書きしない方法で実行します。実行時に重複が発生した場合は、直ちに停止します
コンテンツが不明瞭な場合は、ファイル名から最善の推測を行い、既存の名前を整理するか、注記を添えて変更せずに残します。
テレビ番組のファイルについては、Plex/メディアマネージャーの命名規則を参照してください:references/tv-episodes.md。
コメント
Markdown 対応