前言¶

在本地仓库里列目录、按名称或内容搜文件、统计体积分布，再批量复制、移动或删除，这类事用 shell 一条命令也能做，但在对话式编码环境里，Agent 往往缺少统一、可复用的操作约定，容易反复试探路径、漏掉递归或过滤条件。下面介绍 SkillHub 上的社区 Skill test（坐标 @user_38fa0bef/for-test），它把「列举、搜索、批处理、目录分析」写进 SKILL 规范，供 Agent 在合适场景下按说明调用。

这是什么¶

test 是 SkillHub 分类 dev-programming 下的社区 Skill，当前版本 1.0.1，发布者为 user_38fa0bef，来源标注为 community。官方页面说明其定位为：面向文件系统的高级操作——列举文件、搜索内容、批处理，以及目录结构分析；支持递归搜索、按文件类型过滤、体积分析，以及复制、移动、删除等批量操作。页面标签 requires_api_key=false，表示按 SkillHub 展示无需额外 API Key。

SkillHub 页面：https://www.skillhub.cn/skills/user_38fa0bef/for-test
API 资源地址：https://api.skillhub.cn/user_38fa0bef/for-test

核心功能¶

以下能力均来自官方简介，未在资料中出现的具体命令或参数不在此展开。

1. 列举与浏览：列出目录内容，便于 Agent 建立当前工作区文件视图。
2. 搜索：按文件名或文件内容查找；支持递归搜索与文件类型过滤。
3. 目录分析：分析目录结构，以及文件大小与分布（size analysis）。
4. 批处理：在文件系统层面执行批量复制、移动、删除等操作。

官方建议在需要「列目录、按名或内容搜文件、分析目录结构、批量文件操作、分析体积分布」时使用本 Skill。

安装与启用¶

SkillHub 推荐通过其 CLI 将 Skill 安装到当前 Agent 实际读取的 skills 目录；装错目录会导致 Agent 无法加载，必要时需重启客户端。

1、检查或安装 SkillHub CLI¶

command -v skillhub && skillhub --version

若未安装，可按 SkillHub 安装文档执行完整安装（含默认 Skill）或仅 CLI：

# 完整安装（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、安装本 Skill¶

官方页面给出的安装提示为：依据上述 skillhub.md，安装坐标 @user_38fa0bef/for-test。CLI 示例（--dir 须替换为当前环境的 skills 目录）：

skillhub install user_38fa0bef/for-test --dir <skills 目录>

常用客户端 skills 路径（摘自 SkillHub 安装文档，以你本机为准）：

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

也可将官方提示词交给 AI，让其按 skillhub.md 完成安装；坐标写法为 @user_38fa0bef/for-test。

典型用法¶

公开资料未附带 test 的 SKILL.md 逐步示例，典型用法应结合官方简介，在对话中让 Agent 在已安装本 Skill 的前提下处理下列类型任务（表述需与仓库路径、权限一致）：

1. 递归列出某目录并过滤扩展名，再汇总子目录结构。
2. 在指定根目录下按关键词搜索文件内容，或按 glob 匹配文件名。
3. 统计目录总体积、大文件分布，为清理或迁移提供依据。
4. 对匹配的一批文件执行复制、移动或删除（执行前宜由人确认范围，避免误删）。

经过上面的步骤安装并指向正确 skills 目录后，Agent 会读取 Skill 内说明；具体操作边界以安装包中的 SKILL 文档为准。

适用场景与注意¶

适合谁：经常在 Agent 会话里做仓库巡检、内容检索、批量整理文件、体积分析的开发者；希望把文件系统操作约束在一套 Skill 说明里，减少临时拼 shell 的偏差。

注意：

• 批处理（尤其删除、移动）具有破坏性，应在版本控制或备份前提下使用，并由人确认目标路径。
• SkillHub 页面显示本 Skill 安装数为 0（截至页面抓取时的统计），社区维护，使用前可在 SkillHub 查看版本 v1.0.1 与更新记录。
• 评分 100000、下载 868 等为 SkillHub 页面展示数据，不代表功能完备度；以实际安装后的 SKILL 行为为准。
• 未核实到的客户端差异（除安装路径外）不在此臆测；若某环境不读标准 skills 目录，需按该环境文档调整 --dir。

结尾¶

test（@user_38fa0bef/for-test）把列举、搜索、目录与体积分析、批量复制/移动/删除等文件系统能力封装为 Agent Skill，适合在对话式开发中处理本地仓库的文件级任务。安装与坐标以 SkillHub 为准：https://www.skillhub.cn/skills/user_38fa0bef/for-test