skill

mpp-to-xlsx

Конвертер Microsoft Project .mpp → брендированный Excel .xlsx (CLI + навык Claude Code)

dggalimov/mpp-to-xlsxcommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/dggalimov/mpp-to-xlsx itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 23, 2026

mpp-to-xlsx

Конвертер файлов Microsoft Project (.mpp) в брендированный Excel (.xlsx). Работает и как обычный CLI-скрипт, и как навык (skill) для Claude Code.

Файл .mpp читается через Java-библиотеку MPXJ (мост JPype1), а книга Excel собирается через openpyxl. Результат — 6 листов, оформленных по фирменному стилю «Первый Бит» (маджента-заголовки, уровни СДР цветом строк, без отступов в ячейках).

Возможности

6 листов: Титул · Задачи · Команда · Задачи и исполнители · Ресурсный план · Отчет по ресурсному плану.
Задачи: СДР, длительность в рабочих днях, ТРЗ (трудозатраты), Сумма без/с НДС, команда, заметки; иерархия передаётся цветом строк (уровни СДР) и жирным для родительских задач — без пробельных отступов.
Ресурсный план: дневное распределение трудозатрат по производственному календарю проекта (нормализованная «плоская» таблица — готовый источник для сводной; суммы сходятся с общим объёмом работ).
Отчет по ресурсному плану: кросс-таблица Исполнитель → Задача × Месяц со значениями ТРЗ.
Даты в формате ДД.ММ.ГГ, числовые форматы и выравнивание по столбцам, авто-ширина колонок.

Требования

Java (JRE/JDK 8+) — MPXJ это Java-библиотека. Без установленной Java конвертация не запустится.
- macOS: brew install openjdk (keg-only; скрипт сам находит JAVA_HOME).
Python 3.9+ с пакетами: mpxj, JPype1, openpyxl.
- ⚠️ Пакет mpxj не тянет JPype1 автоматически — ставьте его явно.

Установка

# Java (если ещё нет):  brew install openjdk   (macOS) / Temurin / Adoptium

# Python-зависимости в отдельном venv:
python3 -m venv ~/.mpp_venv
~/.mpp_venv/bin/pip install -r requirements.txt

Использование (CLI)

~/.mpp_venv/bin/python scripts/mpp_to_xlsx.py "/путь/к/plan.mpp"
# результат: /путь/к/plan_export.xlsx

# свой путь назначения:
~/.mpp_venv/bin/python scripts/mpp_to_xlsx.py "plan.mpp" --output "result.xlsx"

Скрипт печатает абсолютный путь готового файла в stdout, краткую сводку и предупреждения — в stderr. JAVA_HOME подбирается автоматически (в т.ч. keg-only Homebrew openjdk); при необходимости задайте вручную.

Как навык Claude Code

# скопировать в каталог навыков:
mkdir -p ~/.claude/skills/mpp
cp SKILL.md ~/.claude/skills/mpp/
cp -r scripts ~/.claude/skills/mpp/

После этого навык срабатывает на фразы вроде «прочитай mpp», «конвертируй project в excel», «открой .mpp» и кладёт <имя>_export.xlsx рядом с исходником. Подробности — в SKILL.md.

Что на листах

Лист	Содержимое
Титул	Наименование проекта, даты начала/окончания, автор, организация, дата отчёта.
Задачи	ID, СДР, Задача, Длит (р.д.), Начало, Конец, ТРЗ, Сумма без/с НДС, Команда, Заметки. Первая строка — «Итого» (СДР 0) с итогами по всему проекту.
Команда	ID, Ресурс, Тип, Ставка, Макс. загрузка %, Стоимость.
Задачи и исполнители	ID задачи, СДР, Задача, Исполнитель, Загрузка %, Трудозатраты, Факт., Сумма.
Ресурсный план	СДР, Задача, Исполнитель, Дата (день), Месяц, ТРЗ — плоская таблица под сводную.
Отчет по ресурсному плану	Сводная: Исполнитель → Задача × Месяц, значения = сумма ТРЗ.

Ограничения

Стоимости и ставки берутся из исходного .mpp. Если в файле они не заполнены — столбцы будут нулевыми.
ТРЗ считаются в человеко-часах; дневное распределение — равномерно по рабочим дням назначения.
Лист «Отчет по ресурсному плану» — вычисляемая кросс-таблица, а не нативная Excel PivotTable: openpyxl не умеет создавать сводные, которые Excel надёжно открывает. Для «живой» сводной постройте PivotTable из листа «Ресурсный план» (Вставка → Сводная таблица).

Лицензия

MIT