file_explorer

File Explorer Skill (File Explorer)

This skill is designed specifically for Alice to explore complex projects, providing a safer and more efficient means than native ls/cat .

Core Features

• Project tree generation (--tree): Quickly display the project directory structure, with support for ignoring ignore files.
• Fuzzy search (--search): Quickly locate files by filename, just like fzf .
• Safe read (--read): Automatically detect file size. If the file is too large, provide chunked reading suggestions to prevent context overflow.

Usage

Run in the terminal:

# 查看项目树状结构 (深度默认为 2)
python skills/file_explorer/explorer.py --tree --depth 3

Fuzzy-search for files containing "config"

python skills/file_explorer/explorer.py --search "config"

Safely read file contents

python skills/file_explorer/explorer.py --read "agent.py"

## 注意事项

Alice 已被权限锁定。此技能仅能访问项目根目录下的文件。严禁尝试访问路径外的内容。
对于 10KB 以上的文件，请优先使用 `--read` 以获取安全分段。