Filesystem

Perform advanced filesystem tasks including listing, recursive searching by name or content, batch copying/moving/deleting files, and analyzing directory siz...

Security Scan

This is an instruction-only filesystem helper whose requested artifacts and instructions match its stated purpose; it contains examples of destructive filesystem commands so use it cautiously.

Purpose & Capability

The skill name and content both describe filesystem listing, searching, batch operations and analysis. There are no unrelated environment variables, binaries, or installs requested — everything the skill needs is standard shell utilities, which is proportionate to its purpose.

Instruction Scope

The SKILL.md is an explicit set of shell commands (find, grep, cp, mv, rm, sed, etc.) that operate on the agent's current filesystem. This is expected for a filesystem tool, but many examples are destructive (delete, move, bulk rename). The instructions do not attempt to read remote endpoints or unrelated credentials, but they do allow modification/deletion of local files — the user should be aware of that risk.

Install Mechanism

There is no install spec and no code to download or write to disk. The document only suggests optional tools (tree, fd, ripgrep) and shows brew install commands — these are normal recommendations and not executed automatically by the skill.

Credentials

The skill requires no environment variables, credentials, or configuration paths. It does note that some operations may require sudo, which is accurate and proportional to filesystem operations.

Persistence & Privilege

The skill is not marked always:true and does not request persistent presence or modify other skills' settings. Default autonomous invocation is allowed by platform but is not unusual or elevated for this skill.

Assessment

This skill is essentially a cookbook of shell commands for working with files and directories. It does not request credentials or install code, but many examples perform destructive actions (bulk delete, move, rename). Before using: (1) run on a non-production copy or in a container/VM if possible, (2) inspect and confirm any command the agent plans to run (especially find ... -delete, mv, rm), (3) list targets first (e.g., use find ... -print or a dry-run) and back up important data, and (4) consider restricting autonomous invocation if you don't want an agent to run filesystem-modifying commands without explicit approval.

Filesystem Operations

文件系统操作工具，提供目录列表、内容搜索、批量处理和目录分析功能。

快速开始

列出目录

# 列出当前目录
ls -la

# 递归列出目录树
find . -type f -name "*.md" | head -20

# 按类型过滤
find . -type f \( -name "*.md" -o -name "*.txt" \)

搜索文件

# 按名称搜索
find . -name "*keyword*"

# 按内容搜索
grep -r "keyword" . --include="*.md"

# 不区分大小写搜索
grep -ri "keyword" . --include="*.md"

分析目录

# 统计文件类型
find . -type f -name "*.md" | wc -l

# 查看目录大小
du -sh .

# 找出最大文件
find . -type f -exec ls -lh {} \; | sort -k5 -h | head -10

---

核心功能

1. 目录列表

基础列表：

ls -la                    # 详细列表
ls -lh                    # 人类可读大小
ls -lt                    # 按修改时间排序
ls -R                     # 递归列表

高级列表：

# 列出特定类型
find . -type f -name "*.md"

# 按深度列出
find . -maxdepth 2 -type f

# 排除特定目录
find . -type f -not -path "*/node_modules/*"

---

2. 文件搜索

按名称搜索：

# 精确匹配
find . -name "filename.md"

# 模式匹配
find . -name "*pattern*"

# 大小写不敏感
find . -iname "*pattern*"

按内容搜索：

# 基础搜索
grep -r "keyword" .

# 包含行号
grep -rn "keyword" .

# 只搜索特定文件
grep -r "keyword" . --include="*.md"

# 排除目录
grep -r "keyword" . --exclude-dir=node_modules

正则表达式搜索：

# 使用正则
grep -r "^## " . --include="*.md"

# 多个关键词
grep -r "key1\|key2" .

# 行首/行尾
grep -r "^关键词" .
grep -r "关键词$" .

---

3. 批量操作

批量复制：

# 复制特定类型
find . -name "*.md" -exec cp {} backup/ \;

# 复制到多个位置
for file in *.md; do cp "$file" dir1/ && cp "$file" dir2/; done

批量移动：

# 移动特定文件
find . -name "*.log" -exec mv {} logs/ \;

# 按条件移动
find . -type f -size +1M -exec mv {} large/ \;

批量删除：

# 删除特定类型
find . -name "*.tmp" -delete

# 删除空目录
find . -type d -empty -delete

# 删除旧文件
find . -type f -mtime +30 -delete

批量重命名：

# 使用 rename 命令
rename 's/old/new/' *.md

# 添加前缀
for file in *.md; do mv "$file" "prefix_$file"; done

---

4. 目录分析

大小分析：

# 总大小
du -sh .

# 各目录大小
du -h --max-depth=1 . | sort -hr

# 最大的文件
find . -type f -exec ls -lh {} \; | sort -k5 -hr | head -10

文件类型统计：

# 按扩展名统计
find . -type f -name "*.md" | wc -l

# 各类型统计
find . -type f -name "*.*" | sed 's/.*\.//' | sort | uniq -c

目录结构分析：

# 目录树
tree -L 2

# 递归深度
find . -type d | wc -l

# 文件分布
find . -type f | cut -d/ -f1-2 | sort | uniq -c

---

5. 文件信息查询

文件详情：

# 完整信息
stat filename

# 只看大小
ls -lh filename

# 只看时间
ls -lt filename

文件内容预览：

# 头部
head -20 filename

# 尾部
tail -20 filename

# 随机行
shuf -n 10 filename

# 字符数
wc -c filename

# 行数
wc -l filename

---

实用工具

tree 命令

# 安装
brew install tree

# 使用
tree -L 2 -I 'node_modules|__pycache__'

fd 命令（快速查找）

# 安装
brew install fd

# 使用
fd "pattern" /path
fd -e md .    # 只找 md 文件
fd -t f .       # 只找文件

ripgrep 命令（快速搜索）

# 安装
brew install ripgrep

# 使用
rg "keyword" .
rg -t md "keyword" .
rg -i "keyword" .          # 不区分大小写
rg --type md "pattern" .

---

最佳实践

1. 搜索优化

• 使用 fd 或 ripgrep 替代 find 和 grep（更快）
• 先缩小搜索范围，再进行深度搜索
• 使用文件类型过滤减少搜索时间

2. 批量操作安全

• 操作前先用 --dry-run 查看会发生什么
• 批量删除前先列出文件确认
• 重要操作前先备份

3. 目录分析

• 使用 -max-depth 限制递归深度
• 使用 -size 过滤大文件
• 使用 -mtime 按时间筛选

---

常见任务

查找并处理 Markdown 文件

# 查找所有 md 文件
find . -name "*.md" -type f

# 统计 md 文件数量
find . -name "*.md" | wc -l

# 列出最大的 md 文件
find . -name "*.md" -exec ls -lh {} \; | sort -k5 -hr | head -5

搜索并替换内容

# 搜索所有匹配项
grep -rn "old_text" . --include="*.md"

# 替换（使用 sed）
find . -name "*.md" -exec sed -i '' 's/old_text/new_text/g' {} \;

清理临时文件

# 删除 .tmp 文件
find . -name "*.tmp" -delete

# 删除空目录
find . -type d -empty -delete

# 删除 30 天前的日志
find . -name "*.log" -mtime +30 -delete

---

安全提醒

⚠️ 批量操作前先确认：

• 列出要操作的文件
• 确认不会误删重要文件
• 考虑先备份

⚠️ 删除操作不可逆：

• rm 删除后无法恢复
• 大批量删除前仔细检查
• 考虑使用 rm -i 交互式删除

⚠️ 权限注意：

• 某些操作可能需要 sudo
• 系统目录操作要谨慎
• 考虑文件权限问题