前言¶

整理素材、导出报表或同步目录时，常会遇到一批文件需要统一加前缀、改序号或按规则替换文件名。用脚本可以一次做完，但每次都要写规则、担心误改扩展名或子目录，改错又难回滚。下面介绍 SkillHub 社区技能 @user_bb79990a/batch-rename2，把常见重命名能力封装成 Agent 可执行的流程，并强调「先预览、再执行」和自动备份。

这是什么¶

批量重命名文件或文件夹 是面向办公效率（分类 office-efficiency）的 Agent Skill，坐标为 @user_bb79990a/batch-rename2，版本 1.0.0，来源为 community，由发布者 user_bb79990a 维护。标签标明 requires_api_key=false，无需额外 API Key。

Skill 的定位是：在对话中根据你的规则批量处理文件或文件夹名称，支持多种改写方式，并在正式改名前给出预览，执行时自动备份，降低误操作风险。

官方入口：

• API：https://api.skillhub.cn/user_bb79990a/batch-rename2
• SkillHub 页面：https://www.skillhub.cn/skills/user_bb79990a/batch-rename2

核心功能¶

以下能力均来自官方简介，已逐项核对页面描述：

1. 前缀 / 后缀：在文件名前或后追加固定文字。
2. 文字替换：将名称中的指定片段替换为新内容。
3. 正则替换：按正则表达式匹配并替换。
4. 序号递增：为一批文件生成连续编号（如 001、002）。
5. 大小写转换：统一为大写、小写等常见形式。
6. 去除指定字符：删掉不需要的字符或片段。
7. 扩展名过滤：只对特定扩展名的文件生效，避免误改无关类型。
8. 子目录递归：对目标路径下的子目录一并处理。

流程上的两个特点同样写在官方说明里：预览确认后再执行；自动备份，便于出错时恢复。

在 Cursor、Claude Code 等客户端里，可用自然语言触发，官方列出的触发词包括：批量重命名、批量改名、文件重命名、文件夹重命名、rename batch、批量修改文件名、批量替换文件名、批量添加前缀、批量添加后缀、批量序号、batch rename。

安装与启用¶

SkillHub 提供两种常见安装方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按文档操作。

方式一：SkillHub CLI¶

若尚未安装 CLI，可先检查版本：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本技能时，必须用 --dir 指向当前 Agent 识别的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。各客户端路径不同，安装文档中的示例如下：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装命令格式（将 <skills 目录> 换成你环境中的实际路径）：

skillhub install user_bb79990a/batch-rename2 --dir <skills 目录>

坐标写法与页面一致时，也可使用 @user_bb79990a/batch-rename2 作为安装标识；具体以当前 skillhub CLI 支持的包名为准。

安装后按你所用客户端的要求重启或刷新 Agent，使新 Skill 生效。

方式二：通过 AI 按文档安装¶

SkillHub 页面提供的提示词为：请根据 https://skillhub.cn/install/skillhub.md 安装 @user_bb79990a/batch-rename2。把该句发给支持 Skill 安装的 AI，由它按同一安装文档完成 CLI 与 --dir 配置。

Cursor / Codex CLI / Claude Code 的差异主要体现在 skills 目录路径 上，安装步骤本身均遵循 SkillHub 通用文档；未在官方资料中单独说明的差异，本文不展开。

典型用法¶

官方页面未附带逐步截图或脚本示例，用法以「在 Agent 对话中说明目标与规则」为主。可复现的交互模式如下。

1. 说明范围：给出要处理的目录路径，并说明是否包含子目录、是否只处理某些扩展名（对应扩展名过滤与递归能力）。
2. 说明规则：用自然语言或触发词描述需求，例如「批量添加前缀 2026-」「把文件名里的空格换成下划线」「用正则去掉末尾的 (1)」「按三位序号从 001 递增」「全部转小写」等，与简介中的能力一一对应。
3. 要求预览：明确要求先列出「旧名 → 新名」预览，确认无误后再执行（对应「预览确认后再执行」）。
4. 确认执行：在预览满意后同意执行；依赖 Skill 侧的自动备份，便于需要时回滚。

示例提示（可根据实际路径改写）：

请用批量重命名技能处理 ~/Downloads/exports 目录（含子目录），只改 .csv 文件：
在文件名前加前缀 report-，并按 001、002 递增编号。先预览全部变更，我确认后再执行，并保留备份。

适用场景与注意¶

适合谁：需要经常整理本地或项目内大量文件名的开发者、运营或办公用户；希望用对话描述规则，而不是每次手写一次性脚本的人。

适合做什么：统一命名规范、批量去噪字符、按批次加序号、按扩展名筛选后改名等，且希望在改名前看到完整预览。

使用时注意：

• 递归处理子目录时，影响范围会变大，预览阶段务必逐条核对路径。
• 正则替换威力大，规则写错可能一次改多批文件；先小范围试目录更稳妥。
• 自动备份能降低风险，但重要数据仍建议在执行前自行额外拷贝或纳入版本管理。
• 安装统计以 SkillHub 抓取为准：评分 100000，下载 1127 次（页面数据会更新，以官网为准）。

结尾¶

@user_bb79990a/batch-rename2 把前缀后缀、替换、正则、序号、大小写、去字符、扩展名过滤和子目录递归等常见重命名需求收进一个 Skill，并用预览确认与自动备份约束执行过程。若你已在用 Cursor、Claude Code 等支持 Skill 的环境，可按上文安装到对应 skills 目录后，用官方触发词直接描述改名任务。

技能详情与安装提示词见：SkillHub - 批量重命名文件或文件夹。