ai-file-naming-system-card:把混乱的文件名整理成一份命名规范卡片

前言

团队里文件命名习惯各不相同,等真正要用的时候,问题才集中暴露:同一批合同,有的叫「合同-最终版.pdf」,有的叫「v2final-盖章.pdf」,还有的叫「新建文件夹(1).pdf」。开发者要么花半天人工归拢,要么写一段正则脚本批量重命名——后者风险更高,一旦规则写错就是一次批量事故。

下面介绍的 ai-file-naming-system-card 走的是不同的路:它不扫描你的文件夹,也不执行任何批量重命名,只把你已经拿到的、用户提供的文件名示例,整理成一份可执行的命名规范卡片和一个安全的重命名队列。先看清楚规则,再动手改文件。

这是什么

ai-file-naming-system-card 是一个社区来源的通用 SKILL.md 格式 Skill,坐标为 @user_15292d5a/yjkj-ai-file-naming-system-card,当前版本 1.0.0,发布者 user_15292d5a,归类在 office-efficiency。

它解决的问题是:用户给出的文件示例通常格式混乱、口径不一,人工归纳命名规则耗时且容易遗漏边界情况。Skill 从这些示例中提炼出一套可用的命名约定,输出为一份「命名规范卡片」,并附带一份顺序明确、可逐条确认的「重命名队列」。

关键边界在于:整个过程不涉及文件夹扫描,也不执行批量重命名。产出的是规则和清单,实际改名动作由使用者自己决定何时、如何执行。

核心功能

根据已抓取的官方资料,该 Skill 的能力边界如下:

1、从用户提供的文件示例中归纳命名约定。输入是用户主动给出的文件名样本,不是对某个目录的遍历结果。

2、产出命名规范卡片。把归纳结果整理成一份结构化、可查阅的约定说明,供团队或脚本后续参照。

3、生成安全的重命名队列。把需要改名的条目排成队列,让使用者能够逐条核对,而不是一次性铺开。

4、不做的事:不扫描文件夹,不执行批量重命名。这两项是它与多数「批量整理文件名」脚本最明显的区别。

标签信息显示 requires_api_key=false,即该 Skill 不需要额外配置 API Key 即可使用。

安装与启用

该 Skill 来自 community 来源,采用通用 SKILL.md 格式。已抓取资料中未提供安装命令、安装目录或配置文件的具体写法,因此本节只列出可核实的坐标信息,安装步骤请以官方页面为准。

技能坐标:

@user_15292d5a/yjkj-ai-file-naming-system-card

官方页面:

https://www.skillhub.cn/skills/user_15292d5a/yjkj-ai-file-naming-system-card

API 地址:

https://api.skillhub.cn/user_15292d5a/yjkj-ai-file-naming-system-card

关于不同宿主的差异:已抓取资料中没有 Cursor、Codex CLI、Claude Code 各自的安装说明,本文不做区分描述。若你需要在某个宿主中启用,请先到上面的官方页面确认该宿主下的安装方式,不要照搬通用命令。

典型用法

已抓取资料未提供官方的可复现命令行示例,下面给出的流程是对官方简介所述能力的展开,用于说明调用时的输入输出边界,不是官方命令,实际参数请以官方页面为准。

输入侧:准备一批用户主动提供的文件名示例。例如用户给出「2025合同终稿.pdf」「2025合同终稿(1).pdf」「2025合同盖章版.pdf」,Skill 会基于这些样本归纳规则。

输出侧一:命名规范卡片。归纳结果可能指向类似下面的约定,具体字段以 Skill 实际产出为准:

{
  "前缀": "日期-类型-版本",
  "日期格式": "YYYYMMDD",
  "分隔符": "-",
  "版本标注": "v1/v2,避免使用「最终版」",
  "禁止项": "括号序号、空格、中文连接词"
}

上面这段是示意,用于说明「卡片」这一产出形态,不是 Skill 的真实配置项。

输出侧二:重命名队列。Skill 会把需要调整的条目排成队列,条目之间保持可逐条确认的顺序,使用者据此决定哪些先改、哪些不改。队列本身不触发任何文件系统操作。

适用场景与注意

适合的场景:

  • 你已经拿到一批真实的文件名样本,希望尽快归纳出统一规则,而不是逐条人工比对。
  • 你希望先把规则定下来、人工过一遍,再决定是否执行改名。这类场景下,「不扫描、不批量重命名」是优点而不是限制。
  • 命名规则需要在团队内部形成文档,供后续脚本或人工同时参照。

需要注意的地方:

1、输入质量决定产出质量。它只处理用户提供的样本,样本本身覆盖不到的情况,规则也会覆盖不到。如果示例里全是「最终版」,卡片里大概率不会凭空出现版本号规范。

2、不替代实际改名。产出是卡片和队列,最终执行改名的是使用者自己。队列需要人工核对后再落地。

3、不要期待它去目录里找样本。明确不支持文件夹扫描,样本需要你自己准备并给出。

4、评分与下载口径。本次抓取的官方页面显示评分 100000、下载 663 次、安装 0 次,标签 requires_api_key=false。100000 这一数值在页面上显示为固定值,参考意义有限,下载数可以作为相对热度参考。另有一份资料给出评分 99713、下载 347 次,与页面不一致,本文以官方页面为准。

5、安装方式缺失。已抓取资料没有提供安装命令与配置字段,若你在配置过程中遇到问题,优先去官方页面核对,不要猜测字段名。

结尾

ai-file-naming-system-card 的价值不在于把文件名批量改掉,而在于先把混乱的样本整理成一份看得懂、能执行的命名规范,再把要改的条目排成可逐条确认的队列。对于「先定规则、后动手」的文件整理流程,它提供了一个比脚本更安全的前置环节。

官方地址:https://www.skillhub.cn/skills/user_15292d5a/yjkj-ai-file-naming-system-card

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜