mcpField
F
file-naming

file-naming

github.com/nweii生产力1080 次安装1 周前更新
代码仓库

关于 file-naming

供 Agent 使用的文件命名技能,可根据内容和元数据提出易读、便于排序的新名称。它会先预览并验证完整方案,再执行更名。

主要功能

  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. 验证计划:如果任何文件无法映射到目标名称,则停止并报告;不要执行部分重命名
  4. 验证计划:确认没有两个文件使用相同的目标名称;如果存在任何冲突,则停止并报告
  5. 提供预览表格:“原文件名” | “新文件名”(文件较多时最多显示 15 个;注明无法分析的文件)
  6. 执行前等待确认
  7. 使用禁止覆盖语义执行——绝不覆盖现有文件;如果执行时发生冲突,立即停止

如果内容不明确:根据文件名尽可能推断、清理现有名称,或保持不变并注明原因。

对于电视剧文件,请参阅 references/tv-episodes.md 中的 Plex/媒体管理器命名规范。

评论

支持 Markdown