Doctor Nexus Filesystem

Perform advanced filesystem tasks including recursive listing, name/content searching, batch copying/moving/deleting, and directory size and type analysis.

Security Scan

Instruction-only filesystem helper whose requests and instructions are consistent with its stated purpose; it contains potentially destructive shell commands but asks for no credentials or external installs.

Purpose & Capability

Name and description match the SKILL.md contents: the document provides commands for recursive listing, searching, batch copy/move/delete, and analysis. Nothing in the files requests unrelated credentials, binaries, or network access.

Instruction Scope

The instructions include destructive operations (find ... -delete, mv, cp, sed -i, rm) and mention use of sudo for privileged operations — this is appropriate for a filesystem tool but requires user caution. The SKILL.md does not instruct reading unrelated files or environment variables, nor does it reference external endpoints. Minor portability note: examples use sed -i '' (BSD/macOS style) and brew for installs, so some commands may behave differently on non-macOS systems.

Install Mechanism

There is no install spec and no code shipped — the skill is instruction-only. No downloads or archive extraction are performed.

Credentials

The skill does not request any environment variables, credentials, or config paths. All commands operate on local filesystem and the declared requirements match the content.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system configuration. It does note operations that may require sudo, which is expected for filesystem tasks and does not imply extra privileges requested by the skill itself.

Assessment

This skill is coherent with its description and contains useful shell examples for filesystem tasks, but many commands are destructive (bulk delete, move, sed replacements, use of sudo). Before letting an agent execute these: (1) review the exact command lines the agent will run; (2) test on a safe sample directory first; (3) list (--dry-run / plain find output) before running delete/mv operations and keep backups; (4) be aware some examples assume macOS (sed -i '' and brew); (5) the skill requests no credentials and performs no network calls, but if you allow autonomous agent execution ensure the agent is restricted or supervised because it could run destructive commands on your files.

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