前言¶
团队里文件命名习惯各不相同,等真正要用的时候,问题才集中暴露:同一批合同,有的叫「合同-最终版.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