# Group By Name

> Group By Name is an Agent Skill for documents published in the CoderWanFeng/python-office repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

按文件名的规则将文件分组整理到不同目录。当用户提到按名称分组文件、整理文件、自动归类时使用。

- Skill name: `group_by_name`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/CoderWanFeng/python-office/blob/HEAD/skills/file/group_by_name/SKILL.md
- Repository: CoderWanFeng/python-office (1,326 GitHub stars when collected)

## SKILL.md

# group_by_name Skill

> 按名称分组整理文件

## 功能描述

按文件名的前缀或规则，将文件分组整理到不同目录中。

> ⚠️ TODO: 该功能为历史功能，行为待测试。

## 所属分类

`office/skills/file/group_by_name/`

## 调用方式

```python
from office.skills.file import group_by_name

group_by_name(
    path='./data',
    output_path=None,
    del_old_file=None
)
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `path` | str | 是 | - | 路径 |
| `output_path` | str | 否 | `None` | 输出路径 |
| `del_old_file` | bool | 否 | `None` | 是否删除旧文件 |

## 返回值

`None`

## 原始函数

`office.api.file.group_by_name`

---

Source: https://www.openparable.com/skill/documents/group-by-name (OpenParable). Cite the canonical URL above.