Initial commit with translated description
This commit is contained in:
208
SKILL.md
Normal file
208
SKILL.md
Normal file
@@ -0,0 +1,208 @@
|
||||
---
|
||||
name: filesystem
|
||||
description: "Clawdbot的高级文件系统操作——列出、搜索、批量处理和目录分析。"
|
||||
homepage: https://github.com/gtrusler/clawdbot-filesystem
|
||||
metadata: {"clawdbot":{"emoji":"📁","requires":{"bins":["node"]}}}
|
||||
---
|
||||
|
||||
# 📁 Filesystem Management
|
||||
|
||||
Advanced filesystem operations for AI agents. Comprehensive file and directory operations with intelligent filtering, searching, and batch processing capabilities.
|
||||
|
||||
## Features
|
||||
|
||||
### 📋 **Smart File Listing**
|
||||
- **Advanced Filtering** - Filter by file types, patterns, size, and date
|
||||
- **Recursive Traversal** - Deep directory scanning with depth control
|
||||
- **Rich Formatting** - Table, tree, and JSON output formats
|
||||
- **Sort Options** - By name, size, date, or type
|
||||
|
||||
### 🔍 **Powerful Search**
|
||||
- **Pattern Matching** - Glob patterns and regex support
|
||||
- **Content Search** - Full-text search within files
|
||||
- **Multi-criteria** - Combine filename and content searches
|
||||
- **Context Display** - Show matching lines with context
|
||||
|
||||
### 🔄 **Batch Operations**
|
||||
- **Safe Copying** - Pattern-based file copying with validation
|
||||
- **Dry Run Mode** - Preview operations before execution
|
||||
- **Progress Tracking** - Real-time operation progress
|
||||
- **Error Handling** - Graceful failure recovery
|
||||
|
||||
### 🌳 **Directory Analysis**
|
||||
- **Tree Visualization** - ASCII tree structure display
|
||||
- **Statistics** - File counts, size distribution, type analysis
|
||||
- **Space Analysis** - Identify large files and directories
|
||||
- **Performance Metrics** - Operation timing and optimization
|
||||
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
# List files with filtering
|
||||
filesystem list --path ./src --recursive --filter "*.js"
|
||||
|
||||
# Search for content
|
||||
filesystem search --pattern "TODO" --path ./src --content
|
||||
|
||||
# Batch copy with safety
|
||||
filesystem copy --pattern "*.log" --to ./backup/ --dry-run
|
||||
|
||||
# Show directory tree
|
||||
filesystem tree --path ./ --depth 3
|
||||
|
||||
# Analyze directory structure
|
||||
filesystem analyze --path ./logs --stats
|
||||
```
|
||||
|
||||
## Command Reference
|
||||
|
||||
### `filesystem list`
|
||||
Advanced file and directory listing with filtering options.
|
||||
|
||||
**Options:**
|
||||
- `--path, -p <dir>` - Target directory (default: current)
|
||||
- `--recursive, -r` - Include subdirectories
|
||||
- `--filter, -f <pattern>` - Filter files by pattern
|
||||
- `--details, -d` - Show detailed information
|
||||
- `--sort, -s <field>` - Sort by name|size|date
|
||||
- `--format <type>` - Output format: table|json|list
|
||||
|
||||
### `filesystem search`
|
||||
Search files by name patterns or content.
|
||||
|
||||
**Options:**
|
||||
- `--pattern <pattern>` - Search pattern (glob or regex)
|
||||
- `--path, -p <dir>` - Search directory
|
||||
- `--content, -c` - Search file contents
|
||||
- `--context <lines>` - Show context lines
|
||||
- `--include <pattern>` - Include file patterns
|
||||
- `--exclude <pattern>` - Exclude file patterns
|
||||
|
||||
### `filesystem copy`
|
||||
Batch copy files with pattern matching and safety checks.
|
||||
|
||||
**Options:**
|
||||
- `--pattern <glob>` - Source file pattern
|
||||
- `--to <dir>` - Destination directory
|
||||
- `--dry-run` - Preview without executing
|
||||
- `--overwrite` - Allow file overwrites
|
||||
- `--preserve` - Preserve timestamps and permissions
|
||||
|
||||
### `filesystem tree`
|
||||
Display directory structure as a tree.
|
||||
|
||||
**Options:**
|
||||
- `--path, -p <dir>` - Root directory
|
||||
- `--depth, -d <num>` - Maximum depth
|
||||
- `--dirs-only` - Show directories only
|
||||
- `--size` - Include file sizes
|
||||
- `--no-color` - Disable colored output
|
||||
|
||||
### `filesystem analyze`
|
||||
Analyze directory structure and generate statistics.
|
||||
|
||||
**Options:**
|
||||
- `--path, -p <dir>` - Target directory
|
||||
- `--stats` - Show detailed statistics
|
||||
- `--types` - Analyze file types
|
||||
- `--sizes` - Show size distribution
|
||||
- `--largest <num>` - Show N largest files
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Clone or install the skill
|
||||
cd ~/.clawdbot/skills
|
||||
git clone <filesystem-skill-repo>
|
||||
|
||||
# Or install via ClawdHub
|
||||
clawdhub install filesystem
|
||||
|
||||
# Make executable
|
||||
chmod +x filesystem/filesystem
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Customize behavior via `config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"defaultPath": "./",
|
||||
"maxDepth": 10,
|
||||
"defaultFilters": ["*"],
|
||||
"excludePatterns": ["node_modules", ".git", ".DS_Store"],
|
||||
"outputFormat": "table",
|
||||
"dateFormat": "YYYY-MM-DD HH:mm:ss",
|
||||
"sizeFormat": "human",
|
||||
"colorOutput": true
|
||||
}
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Development Workflow
|
||||
```bash
|
||||
# Find all JavaScript files in src
|
||||
filesystem list --path ./src --recursive --filter "*.js" --details
|
||||
|
||||
# Search for TODO comments
|
||||
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2
|
||||
|
||||
# Copy all logs to backup
|
||||
filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve
|
||||
|
||||
# Analyze project structure
|
||||
filesystem tree --path ./ --depth 2 --size
|
||||
```
|
||||
|
||||
### System Administration
|
||||
```bash
|
||||
# Find large files
|
||||
filesystem analyze --path /var/log --sizes --largest 10
|
||||
|
||||
# List recent files
|
||||
filesystem list --path /tmp --sort date --details
|
||||
|
||||
# Clean old temp files
|
||||
filesystem list --path /tmp --filter "*.tmp" --older-than 7d
|
||||
```
|
||||
|
||||
## Safety Features
|
||||
|
||||
- **Path Validation** - Prevents directory traversal attacks
|
||||
- **Permission Checks** - Verifies read/write access before operations
|
||||
- **Dry Run Mode** - Preview destructive operations
|
||||
- **Backup Prompts** - Suggests backups before overwrites
|
||||
- **Error Recovery** - Graceful handling of permission errors
|
||||
|
||||
## Integration
|
||||
|
||||
Works seamlessly with other Clawdbot tools:
|
||||
- **Security Skill** - Validates all filesystem operations
|
||||
- **Git Operations** - Respects .gitignore patterns
|
||||
- **Backup Tools** - Integrates with backup workflows
|
||||
- **Log Analysis** - Perfect for log file management
|
||||
|
||||
## Updates & Community
|
||||
|
||||
**Stay informed about the latest Clawdbot skills and filesystem tools:**
|
||||
|
||||
- 🐦 **Follow [@LexpertAI](https://x.com/LexpertAI)** on X for skill updates and releases
|
||||
- 🛠️ **New filesystem features** and enhancements
|
||||
- 📋 **Best practices** for file management automation
|
||||
- 💡 **Tips and tricks** for productivity workflows
|
||||
|
||||
Get early access to new skills and improvements by following @LexpertAI for:
|
||||
- **Skill announcements** and new releases
|
||||
- **Performance optimizations** and feature updates
|
||||
- **Integration examples** and workflow automation
|
||||
- **Community discussions** on productivity tools
|
||||
|
||||
## License
|
||||
|
||||
MIT License - Free for personal and commercial use.
|
||||
|
||||
---
|
||||
|
||||
**Remember**: Great filesystem management starts with the right tools. This skill provides comprehensive operations while maintaining safety and performance.
|
||||
Reference in New Issue
Block a user