---
name: openakita/skills@file-manager
description: |
  文件和目录管理工具。创建、读取、写入、删除、移动、复制文件。
  搜索文件、列出目录、获取文件信息。
  关键词: 文件, 目录, 创建, 删除, 复制, 移动, 搜索, 列出
license: MIT
metadata:
  author: myagent
  version: "1.0.0"
---

# File Manager

管理文件和目录的工具集。

## When to Use

- 创建、删除、移动、复制文件或目录
- 读取或写入文件内容
- 搜索文件
- 列出目录内容
- 获取文件信息（大小、修改时间等）

## Instructions

### 列出目录

```bash
python scripts/file_ops.py list <path> [--recursive] [--pattern "*.py"]
```

### 读取文件

```bash
python scripts/file_ops.py read <file_path> [--encoding utf-8]
```

### 写入文件

```bash
python scripts/file_ops.py write <file_path> --content "内容" [--append]
```

### 复制文件

```bash
python scripts/file_ops.py copy <source> <destination>
```

### 移动/重命名

```bash
python scripts/file_ops.py move <source> <destination>
```

### 删除

```bash
python scripts/file_ops.py delete <path> [--recursive]
```

### 搜索文件

```bash
python scripts/file_ops.py search <directory> --pattern "*.py" [--content "search_text"]
```

### 获取文件信息

```bash
python scripts/file_ops.py info <path>
```

## Output Format

所有操作返回 JSON 格式:

```json
{
  "success": true,
  "operation": "list",
  "data": {
    "files": ["file1.py", "file2.py"],
    "directories": ["subdir"],
    "count": 3
  }
}
```

## Safety Notes

- 删除操作不可恢复，谨慎使用
- 写入文件会覆盖原有内容（除非使用 --append）
- 对于重要文件，建议先备份