前言¶
日常开发里，列目录、按名或内容找文件、看体积分布、批量复制/移动/删除，往往要在终端和编辑器之间来回切。把这些步骤交给带工具的 Agent 时，若没有统一指引，容易漏掉递归范围、类型过滤或批量操作前的确认。下面介绍 SkillHub 上的 test-2（坐标 @user_38fa0bef/for-test2）：用标准 SKILL.md 格式，把「高级文件系统操作」收敛成 Agent 可遵循的能力说明，便于在对话里完成列举、搜索、目录分析与批处理。
这是什么¶
test-2 是社区来源（community）的 Skill，发布者为 user_38fa0bef，当前版本 1.0.1，分类为 dev-programming。官方简介将其定位为：面向列举文件、搜索内容、批处理与目录分析的高级文件系统操作；支持递归搜索、按文件类型过滤、体积分析，以及复制/移动/删除等批量操作。标签标明 requires_api_key=false，安装后不需要额外 API Key。
- SkillHub 页面：https://www.skillhub.cn/skills/user_38fa0bef/for-test2
- API 条目：https://api.skillhub.cn/user_38fa0bef/for-test2
（页面统计以抓取资料为准：评分 100000，下载 803，安装 0。）
核心功能¶
以下能力均来自官方简介，未在资料中出现的具体命令或脚本不在此展开。
- 列举与目录分析：列出目录内容，分析目录结构。
- 按名与按内容搜索：支持递归搜索，并可按文件类型过滤。
- 体积与分布：分析文件大小及分布情况。
- 批量操作：在 Agent 工作流中处理复制、移动、删除等批处理需求。
官方建议在以下情况启用该 Skill：需要列目录、按名称或内容找文件、分析目录结构、执行批量文件操作，或分析文件大小与分布。
安装与启用¶
SkillHub 提供两种常见安装路径：用 CLI 装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 由其按官方文档执行。
1、确认 SkillHub CLI¶
先检查本机是否已有 skillhub：
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
说明与命令出处：https://skillhub.cn/install/skillhub.md
2、安装 test-2 到 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；默认装到 ./skills/ 可能不会被识别。文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 下可执行（将目录换成你环境中的路径）：
skillhub install user_38fa0bef/for-test2 --dir ~/.cursor/skills/
坐标写法与页面一致时，也可使用 @user_38fa0bef/for-test2 作为搜索或安装时的标识；以你本机 skillhub search for-test2 的匹配结果为准。
3、通过对话让 AI 安装¶
SkillHub 技能页提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_38fa0bef/for-test2`。
把上述内容发给当前 Agent，由其按 skillhub.md 完成 CLI 检查、目录选择与安装。安装后按你所用客户端要求重启或刷新技能列表（以客户端文档为准）。
典型用法¶
公开资料未附带 test-2 包内 SKILL.md 的逐步示例；用法应围绕官方列出的意图，用自然语言向已启用该 Skill 的 Agent 描述任务，并明确工作区根路径、是否递归、文件类型与批量操作范围。
可参考的提问方向（表述需结合你的真实路径与约束）：
- 列举：「列出某目录下（是否包含子目录）的文件与子目录。」
- 按名搜索：「在指定树下递归查找匹配某模式的文件名。」
- 按内容搜索：「在某类文件（如
.py）中搜索包含某字符串的文件。」 - 结构分析：「汇总某项目的目录层级或某类文件的分布。」
- 体积分析：「统计某目录下文件大小排序或体积分桶。」
- 批处理：「在确认列表后，对匹配的一批文件执行复制/移动/删除（应要求 Agent 先列出拟操作清单）。」
经过上面的步骤启用 Skill 后，Agent 会按 SKILL 内指引选择合适工具；你仍需在对话中限定路径与是否允许破坏性操作，避免误删或越界访问。
适用场景与注意¶
适合谁：需要在 IDE Agent（如 Cursor）里频繁做仓库内文件巡检、内容检索、目录与体积分析，或经确认后的批量整理，且希望用统一 Skill 约束操作边界的开发者。
注意：
- 批量删除、移动等操作具有破坏性，务必先让 Agent 输出待处理列表并人工确认。
- 递归搜索与大目录体积统计可能耗时，应缩小根路径或加上类型过滤（能力与官方简介一致，具体策略以 SKILL 正文为准）。
- 安装统计中的「安装 0」仅表示 SkillHub 侧计数，不代表你本机未安装；以本地 skills 目录是否出现该包为准。
- 未在资料中核实的客户端差异（除安装路径示例外）不臆测；其他 Agent 请对照
skillhub.md第四节自行映射--dir。
结尾¶
test-2 把列举、递归搜索、类型过滤、体积分析与复制/移动/删除等文件系统任务，整理成面向 Agent 的 Skill，适合在开发工作流里减少手工敲命令、又需要可控批处理的场景。当前版本 1.0.1，无需 API Key。详情与安装入口：https://www.skillhub.cn/skills/user_38fa0bef/for-test2
