docs-staff-listlisted
Install: claude install-skill obviousbread/docs-skills
# docs-staff-list — сводный список сотрудников
Создавать один `.xlsx` с колонками:
| № | Сотрудник | Дата рождения | Должность | Подразделение | Филиал |
|---|---|---|---|---|---|
Использовать `scripts/normalize.py`. Не классифицировать форматы вручную до запуска `--probe`.
## 1. Определить вход
Собрать переданные `.xls`/`.xlsx`. Если для одного филиала есть основной, внешний и объединённый варианты, выбрать один файл с нужным охватом — обычно объединённый. Не включать готовый общий сводный вместе с филиальными файлами.
При новой или непонятной структуре прочитать `references/formats.md`.
## 2. Выполнить probe
```bash
python3 scripts/normalize.py --probe --input-dir "/path/to/input"
```
Для выбранных файлов:
```bash
python3 scripts/normalize.py --probe \
--input-dir "/path/to/input" \
--files "branch-a.xlsx" "branch-b.xls"
```
Проверить для каждого файла формат, число строк и источник филиала. Если филиал угадан из имени, задать человекочитаемое значение через `--branch-map`.
## 3. Выбрать выход
Прочитать `~/.docs-plugin/org_details.md`, если он существует.
- Если `staff_file` указывает на каталог, создать в нём датированную подпапку и сводный файл: `<staff_file>/<ДД.ММ.ГГГГ>/Сводный список сотрудников <ДД.ММ.ГГГГ>.xlsx`.
- Если `staff_file` указывает на конкретный файл или не задан, выбрать явный путь в папке текущей задачи.
- Всегда передавать итоговый путь через `--output`. Не перезаписывать существующий файл без явной просьбы.
## 4. Создать сводный
```