关于 file-naming
供 Agent 使用的文件命名技能,可根据内容和元数据提出易读、便于排序的新名称。它会先预览并验证完整方案,再执行更名。
主要功能
- 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、文本提取、视觉分析和文件名模式分析文件
- 采取任何操作前,先制定完整的重命名计划
- 验证计划:如果任何文件无法映射到目标名称,则停止并报告;不要执行部分重命名
- 验证计划:确认没有两个文件使用相同的目标名称;如果存在任何冲突,则停止并报告
- 提供预览表格:“原文件名” | “新文件名”(文件较多时最多显示 15 个;注明无法分析的文件)
- 执行前等待确认
- 使用禁止覆盖语义执行——绝不覆盖现有文件;如果执行时发生冲突,立即停止
如果内容不明确:根据文件名尽可能推断、清理现有名称,或保持不变并注明原因。
对于电视剧文件,请参阅 references/tv-episodes.md 中的 Plex/媒体管理器命名规范。
评论
支持 Markdown