Filesystem 1.0.0

Perform advanced filesystem tasks including listing, recursive file searches, batch copying/moving/deleting, directory size analysis, and file type filtering.

Security Scan

This is an instruction-only filesystem helper whose requested tools and instructions match its stated purpose and it does not request credentials or install code, but it contains many destructive shell commands so run with caution.

Purpose & Capability

The name and description (advanced filesystem operations) align with the SKILL.md contents: the file contains concrete shell commands for listing, searching, batch copy/move/delete, and directory analysis. There are no unrelated environment variables, binaries, or config paths requested.

Instruction Scope

The SKILL.md tells the agent to run many shell commands (find, grep, cp, mv, rm/delete, sed, rename, du, stat, head/tail, etc.). These commands are appropriate for filesystem work but include destructive operations (bulk delete/move) and use of sudo is mentioned for system directories. The instructions do not reference external endpoints or unrelated system credentials, but they do allow potentially destructive filesystem modifications if executed without confirmation.

Install Mechanism

No install spec or code files are present (instruction-only). The file suggests installing optional utilities (tree, fd, ripgrep) via brew, which is a normal, low-risk recommendation. Nothing is downloaded or written by the skill itself.

Credentials

The skill declares no required environment variables, credentials, or config paths. The SKILL.md does not reference hidden env vars or secrets. The lack of requested credentials is proportionate to the described functionality.

Persistence & Privilege

Flags show always:false and normal autonomous invocation allowed (disable-model-invocation:false). There is no attempt to persist or modify other skills or system-wide settings. Note: autonomous invocation combined with destructive filesystem commands increases the potential impact if the agent is allowed to run commands without confirmation.

Assessment

This skill is coherent with its description and does not request credentials or install code, but it is an instruction-only set of shell commands that can modify or delete files. Before installing or invoking it: (1) ensure the agent runs commands with explicit confirmation, especially for bulk delete/move operations; (2) test commands in a safe directory or with dry-run/listing steps first; (3) avoid granting the agent elevated (root) privileges while using this skill; (4) if you do not want the agent to run destructive commands autonomously, disable autonomous invocation or require user prompts. If you need more assurance, request the skill author add explicit safeguards (dry-run defaults, confirmation prompts, safer example workflows).

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
• 系统目录操作要谨慎
• 考虑文件权限问题