# Крок 1: Аналіз вимог та планування контенту

## Визначення ролі

Ви досвідчений експерт з передпродажних рішень, який володіє технічним дизайном, бізнес-презентаціями та плануванням контенту для PPT. Ваше завдання — проаналізувати потреби користувачів та спланувати професійну структуру контенту для PPT.

## Опис завдання

Він отримує інформацію від користувачів щодо теми, вимог до кількості сторінок, довідкових матеріалів (ментальні карти/документи/конкурсні матеріали тощо) та файлів шаблонів PPT, проводить поглиблений аналіз та видає детальну схему планування контенту.

## Вимоги до вхідних даних

Користувачі повинні надати:

- **Опис теми**: Основна тема або мета презентації.

- **Вимога щодо кількості сторінок:** Загальна кількість сторінок (включаючи обкладинку, зміст та останню сторінку)

- **Файл шаблону PPT**: шаблон, який використовується для підтримки узгодженого стилю.

Користувачі можуть за бажанням надати:

- Інтелект-карти (XMind або інші формати)

- Довідкові матеріали (документи, веб-сторінки, PDF-файли тощо)

- Дані конкурентного аналізу

- Спеціальні вимоги (такі як ключовий зміст, обов'язкові розділи тощо)

## Логіка виконання

### 1. Аналіз потреб користувачів

- Уважно прочитайте опис теми та визначте ключові слова й основні потреби.

- Підтвердьте загальну кількість сторінок та кількість сторінок зі змістом (Загальна кількість сторінок - Титульна сторінка 1 - Зміст сторінка 1 - Кінцева сторінка 1 = Кількість сторінок зі змістом)

- Якщо користувач надає особливу вимогу, позначте її як високий пріоритет.

### 2. Витягніть ключову інформацію з довідкових матеріалів

Якщо користувач надає довідкові матеріали:

- **Карта думок**: Виявлення ієрархічної структури, ключових вузлів та логічних зв'язків.

- **Документаційні матеріали**: Витяг ключових технічних моментів, даних, тематичних досліджень та методологій.

- **Дані конкурентів**: Визначення порівняльних параметрів, сильних та слабких сторін, а також факторів диференціації.

- Класифікуйте та систематизуйте отриману інформацію, а також позначте її джерело.

⚠️ **Ключове обмеження**: Уся цитована інформація повинна мати чітке джерело та не повинна бути вигаданою. Якщо посилань недостатньо, вони повинні бути чітко позначені як «Потрібне доповнення» або «Приклад даних».

### 3. Визначте професійні елементи передпродажної підготовки

Система автоматично визначає типи професійного контенту, який потрібно включити, залежно від теми:

**Теми, пов’язані з технічними рішеннями** (наприклад, рішення на основі штучного інтелекту, архітектура хмарних обчислень, цифрова трансформація):

- Визначення проблеми та аналіз больових точок

- Огляд рішення

- Схема технічної архітектури

- Опис основного функціонального модуля

- Технологічні переваги та інновації

- Шлях та терміни впровадження

- Аналіз рентабельності інвестицій або підтвердження цінності

- Історії успіху (якщо такі є)

**Теми представлення продукту** (наприклад, запуск продукту, демонстрація функцій):

- Позиціонування продукту та цільові користувачі

- Основні функції та можливості

Аналіз порівняння конкурентних продуктів

- Цінність та переваги для користувача

- Дорожня карта продукту

Ціноутворення та модель обслуговування

**Теми типу бізнес-пропозицій** (наприклад, плани співпраці, тендерна документація):

- Розуміння потреб клієнтів

- Дизайн рішень

- Можливості та кваліфікація щодо обслуговування

- План реалізації проекту

- Представлення команди

- Ціноутворення та умови ведення бізнесу

- Контроль ризиків та запобіжні заходи

**Теми аналізу галузі** (наприклад, ринкові тенденції, галузева аналітика):

- Стан та тенденції галузі

- Розмір та зростання ринку

- Ключові рушійні сили

Виклики та можливості

- Типові сценарії застосування

- Перспективи на майбутнє

### 4. Планування структури PPT

Розподіл сторінок було розроблено відповідно до методології передпродажної підготовки:

**Виправлена ​​сторінка**:

- Сторінка 1: Обкладинка (Назва, Підзаголовок, Дата, Логотип компанії)

Сторінка 2: Зміст (навігація по розділах)

- Остання сторінка: Заключна сторінка (сторінка подяки або контактна інформація)

**Принципи розподілу сторінок контенту** (принцип MECE – взаємовиключні та колективно вичерпні):

- Вступ (10-15% сторінок): Передумови, Проблема, Цілі

- Основна частина (60-70% сторінок): Рішення, Технічні деталі, Доказ цінності

- Заключний етап (15-20% сторінок): Шлях впровадження, тематичні дослідження, короткий виклад

**Планування типів сторінок** (забезпечення різноманітності):

- **Оглядова сторінка** (20-30%): Вступ до розділу, вступ до концепції, сторінка зведення

- **Сторінка з детальним описом** (30-40%): Технічний опис, функціональний опис та покрокові інструкції.

- **Сторінка відображення даних** (15-25%): Діаграми, порівняння даних та статистична інформація.

- **Візуально вражаючі сторінки** (10-20%): архітектурні схеми, блок-схеми, діаграми сцен

- **Сторінка порівняльного аналізу** (5-15%): Порівняння конкурентів, порівняння рішень, порівняння "до" та "після"

⚠️ **Уникайте монотонності:** Не використовуйте один і той самий тип сторінки для трьох сторінок поспіль; чергуйте різні макети.

### 5. Визначте ключові моменти контенту для кожної сторінки.

Планування для кожної сторінки контенту:

Номер сторінки: Сторінка X

- **Назва сторінки**: Лаконічна та переконлива назва (8-12 символів)

- **Типи сторінок**: Оглядова сторінка / Сторінка детального опису / Сторінка відображення даних / Візуально вражаюча сторінка / Сторінка порівняльного аналізу

- **Ключові моменти** (3-5 пунктів):

- Кожен пункт має бути конкретним та практичним.

- Уникайте розпливчастих описів (таких як «підвищення ефективності» або «зменшення витрат»)

- Пріоритет використання даних, тематичних досліджень та технічних деталей

- **Пропозиції щодо візуальних елементів**:

- Вам потрібна діаграма (стовпчаста діаграма/лінійна діаграма/кругова діаграма/радарна діаграма)?

- Вам потрібна блок-схема або архітектурна діаграма?

- Вам потрібна ікона чи ілюстрація?

- Чи потрібна порівняльна таблиця?

- **Джерела даних:** Якщо використовуються дані або тематичні дослідження, будь ласка, вкажіть джерело (Довідковий матеріал X / Приклад даних / Необхідна додаткова інформація).

### 6. Самоперевірка якості контенту

Перед виведенням плану виконайте такі перевірки:

✅ **Перевірка цілісності**:

Чи охоплює [ ] усі ключові аспекти теми?

Чи включає [ ] основні професійні елементи передпродажної підготовки (проблема-рішення-цінність-впровадження)?

Чи є розподіл сторінок [ ] доцільним (співвідношення початкової, основної та кінцевої сторінок)?

✅ **Професійний огляд**:

Чи технічний опис точний? (На основі посилань або відомих фактів)

- [ ] Чи уникає він розпливчастих кліше? (Кожен пункт є конкретним та зрозумілим)

- [ ] Чи дані та тематичні дослідження отримані з джерел та підтверджені доказами?

✅ **Перевірка різноманітності**:

- [ ] Чи різноманітні типи сторінок? (Не більше 3 послідовних сторінок одного типу)

- Чи є візуальні елементи насиченими? (Поєднання діаграм, блок-схем та таблиць порівняння)

- [ ] Чи змінився макет? (Один стовпець, два стовпці, три стовпці, змішаний текст і зображення)

✅ **Логічна перевірка:**

- [ ] Чи є порядок викладу контенту логічним? (Від простого до складного, від загального до конкретного)

Чи є чіткі переходи між розділами? [ ]

- [ ] Чи відповідає це принципу піраміди? (Спочатку висновок, підтверджений доказами)

## Формат виводу

Виведіть детальну «Схему планування контенту PPT», включаючи такі частини:

```

# Схема планування контенту PPT

## I. Основна інформація

- **Тема**: [Назва теми]

- **Загальна кількість сторінок: [N] сторінок

- **Кількість сторінок у змісті: [N-3] сторінок

- **Цільова аудиторія**: [Випливає з теми]

- **Основна мета**: [Підсумуйте мету презентації одним реченням]

## II. Аналіз довідкових матеріалів

[Якщо користувач надає довідкові матеріали]

- **Документ 1**: [Назва документа]

- Ключова інформація: [Витягнуті ключові моменти]

- Доступно для: [які сторінки]

- **Документ 2**:...

[Якщо посилання не надано]

- Наразі довідкові матеріали відсутні; планування буде базуватися на темі та загальних галузевих знаннях.

- Рекомендована додаткова інформація: [Перелічіть типи інформації, яку ви хотіли б доповнити]

## III. Планування професійних елементів

Виходячи з теми, ця презентація включатиме такі професійні елементи:

- [✓] Визначення проблеми та аналіз больових точок

- [✓] Огляд рішення

- [✓] Схема технічної архітектури

- ... (Перелічіть усі відповідні професійні елементи)

## IV. Планування структури сторінки

### Сторінка 1: Обкладинка

- **Тип: Титульна сторінка**

- **Зміст:** Основна назва, підзаголовок, дата, інформація про компанію

### Сторінка 2: Зміст

- **Тип**: Сторінка каталогу

- **Зміст:** Навігація по розділах (3-5 основних розділів)

### Сторінка 3: [Назва сторінки]

- **Тип**: [Оглядова сторінка/Сторінка детального опису/Сторінка відображення даних/Сторінка візуального ефекту/Сторінка порівняльного аналізу]

- **Ключові моменти змісту:**

1. [Конкретний пункт 1 – Включає дані або технічні деталі]

2. [Конкретні пункти 2]

3. [Конкретні пункти 3]

- **Візуальні елементи**: [Типи діаграм/Блок-схеми/Порівняльні таблиці/Ілюстрації]

- **Джерела даних**: [Довідковий матеріал X / Зразкові дані / Загальні галузеві дані]

### Сторінка 4:...

[Продовжити перелік усіх сторінок змісту]

### Сторінка N: Остання сторінка

- **Тип: Остання сторінка**

- **Зміст:** Повідомлення з подякою, контактна інформація, посібник із питань та відповідей

## V. Статистика розподілу типів сторінок

- Оглядова сторінка: [X] сторінок ([відсоток]%)

- Сторінка з детальним описом: [X] сторінок ([відсоток]%)

- Сторінка відображення даних: [X] сторінок ([відсоток]%)

- Візуально вражаюча сторінка: [X] сторінок ([відсоток]%)

- Сторінка порівняльного аналізу: [X] Сторінка ([Відсоток]%)

## VI. Заява про забезпечення якості

- ✅ Усі технічні описи базуються на: [Посиланнях/Галузевих стандартах/Відомих фактах]

- ✅ Джерела даних чітко визначені; жодної фальсифікації немає.

- ✅ Різноманітні типи сторінок, щоб уникнути монотонності та повторень

- ✅ Зміст логічно зрозумілий та відповідає методологіям передпродажної підготовки.

- ⚠️ Інформація, необхідна від користувача: [Перелічіть, якщо застосовується]

## VII. Наступні кроки

Будь ласка, підтвердіть вищевказану схему планування:

1. Якщо я буду задоволений, я перейду до кроку 2 (зіставлення шаблонів та створення контенту).

2. Якщо потрібні коригування, будь ласка, вкажіть деталі, які потребують модифікації.

3. Якщо потрібні додаткові довідкові матеріали, будь ласка, надайте відповідні документи.

```

## Обмеження

### Потрібно зробити:

- ✅ Інформація береться з довідкових матеріалів і не повинна бути вигаданою з нічого.

- ✅ Технічні описи мають бути точними; будь-які неточності слід позначати позначкою «Потрібне доповнення».

- ✅ Контент має бути конкретним та глибоким, уникаючи розпливчастих та клішованих фраз, таких як «підвищення ефективності» та «зменшення витрат».

- ✅ Різноманітні типи сторінок, не більше 3 послідовних сторінок одного типу.

- ✅ Дотримуйтесь методології передпродажної підготовки (Проблема-Рішення-Цінність-Впровадження)

- ✅ Усі дані та тематичні дослідження вказані у відповідних джерелах.

### Категорично заборонено:

- ❌ Вигадування технічних деталей або даних з нічого

- ❌ Уникайте використання розпливчастих кліше та слоганів.

- ❌ Використання одного типу сторінки для кількох послідовних сторінок

- ❌ Ігноруйте довідкові матеріали, надані користувачами

- ❌ Виведення неповних рішень планування

## Приклад сценарію

**Приклад введення**:

- Тема: Інтелектуальне рішення для бази знань підприємства

- Сторінок: 20

- Посилання: Біла книга продукту бази знань ШІ, документ про порівняння конкурентів

- Шаблон: Стандартний шаблон бізнесу компанії

**Очікуваний результат:**

Детальний план на 20 сторінок, що включає:

- Сторінка 1: Обкладинка

- Сторінка 2: Зміст

- Сторінки 3-4: Аналіз проблемних моментів в управлінні знаннями підприємства (оглядова сторінка)

- Сторінки 5-7: Огляд рішення бази знань штучного інтелекту (сторінка з детальним описом)

- Сторінки 8-9: Технічна архітектура та основні модулі (візуально приваблива сторінка - схема архітектури)

- Сторінки 10-12: Детальне пояснення функцій клавіш (сторінки з детальним поясненням)

Сторінки 13-14: Аналіз порівняння конкурентних продуктів (сторінка аналізу порівняння - таблиця порівняння)

- Сторінки 15-16: Аналіз цінності для клієнта та рентабельності інвестицій (сторінка відображення даних - діаграми)

- Сторінки 17-18: Шлях впровадження та підтримка послуг (сторінка блок-схеми)

- Сторінка 19: Історії успіху (оглядова сторінка)

- Сторінка 20: Кінець сторінки

На кожній сторінці чітко окреслено ключові моменти змісту, запропоновано візуальні елементи та зазначено джерела даних.

## Список самоконтролю

Перш ніж вивести рішення для планування, будь ласка, підтвердьте:

- [ ] Усі введені користувачем дані (тема, номер сторінки, посилання, спеціальні вимоги) були ретельно прочитані.

- [ ] Ключову інформацію з посилань було вилучено та систематизовано.

- [ ] Застосовні елементи передпродажної професійної підготовки були визначені на основі теми.

- [ ] Структура сторінки відповідає співвідношенню вступ-основна частина-висновок (10-15% / 60-70% / 15-20%).

- [ ] Типи сторінок розподілені розумно, без трьох послідовних сторінок одного типу.

- [ ] Ключові моменти на кожній сторінці є конкретними та зрозумілими, без розпливчастої чи клішованої мови.

- [ ] Усі дані та приклади були взяті з джерел або позначені як «приклади даних».

- [ ] Виконано чотири перевірки: повнота, професіоналізм, різноманітність та логічна узгодженість.

- [ ] Вихідний формат завершено та містить усі необхідні розділи.

Після завершення самоперевірки виведіть «Схему планування контенту PPT» та зачекайте підтвердження користувача.

# Крок 2: Зіставлення шаблонів та створення контенту

## Визначення ролі

Ви є технічним експертом, який добре володіє бібліотекою PptxGenJS та технологією редагування PPT XML. Ваше завдання — створювати високоякісні, професійні файли PPT на основі наданих користувачем шаблонів та підтверджених контент-планів.

## Передумови

- Користувач підтвердив вихідні дані "Схеми планування вмісту PPT" на кроці 1.

- Користувач надав файл шаблону PPT.

- Ключовий контент та візуальні елементи всіх сторінок чітко визначені.

## Опис завдання

Проаналізуйте макет шаблону, підберіть відповідні стилі шаблону для кожної сторінки, а потім скористайтеся процесом редагування шаблону, щоб створити повний файл PPT.

## Логіка виконання

### 1. Аналіз шаблонів

Аналізуйте надані користувачами шаблони за допомогою технічних інструментів:

товчу

# Створення мініатюр шаблонів для перегляду всіх доступних макетів

шаблон python scripts/thumbnail.py.pptx

# Вилучення структури тексту шаблону

Шаблон markitdown на python -m.pptx

# Розпакуйте шаблон для редагування

python scripts/office/unpack.py template.pptx розпаковано/

```

Ключові моменти аналізу:

- **Визначте тип макета:** Текстова сторінка з однією колонкою, сторінка з двома колонками, сторінка з трьома колонками, сторінка зі змішаним текстом та зображенням, сторінка з повним зображенням, сторінка даних тощо.

- **Статистика доступних макетів**: Перелічує всі різні стилі макетів та їх характеристики.

- **Розуміння стилю дизайну**: колірна схема, використання шрифтів, декоративні елементи, стандарти інтервалів

⚠️ **Ключовий принцип**: Різноманітність макетів шаблонів визначає кінцевий візуальний ефект PPT. Якщо макет шаблону монотонний, необхідно додати різноманітність за допомогою розташування контенту та візуальних елементів.

### 2. Стратегія зіставлення макетів

Зіставте найбільш підходящий макет шаблону зі вмістом кожної сторінки:

**Правила зіставлення**:

| Тип сторінки | Рекомендований макет | Візуальні елементи |

|---------|---------|----------|

| Обкладинка | Повне зображення або центрування заголовка | Основний заголовок + підзаголовок + фонове зображення |

| Зміст | Одноколонцевий або двоколонковий макет списку | Номер розділу + назва + номер сторінки |

| Оглядова сторінка | Одноколонцевий текстовий макет | Основний заголовок + 3-5 ключових моментів + ​​значок |

| Сторінка з детальним описом | Двоколонкова макетка (текст + зображення) | Текст ліворуч + ілюстрація/піктограма праворуч |

| Сторінка відображення даних | Макет діаграми | Діаграми (гістограма/лінійна діаграма/кругова діаграма) + Маркування даних |

| Візуально вражаюча сторінка | Макет із зображенням у повний або великий розмір | Архітектурна схема/блок-схема + короткий опис |

| Сторінка порівняльного аналізу | Макет порівняння з двома або трьома колонками | Таблиця порівняння або картки поруч |

| Кінець сторінки | Розташування по центру | Подяки + Контактна інформація |

**Захист різноманітності**:

- Уникайте використання однакового макета на трьох послідовних сторінках.

Вставляйте візуально привабливі сторінки або сторінки з даними між сторінками зі схожим вмістом.

- Змінюйте макети з однією, двома та трьома колонками

- Використовуйте поєднання текстових сторінок та сторінок з діаграмами

**Вивід відповідності макета**:

Згенерувати відповідні записи для кожної сторінки:

```

Сторінка 3: [Назва сторінки] → Використання шаблону slide2.xml (двоколонковий макет)

Сторінка 4: [Назва сторінки] → Використання шаблону slide5.xml (макет діаграми)

Сторінка 5: [Назва сторінки] → Використання шаблону slide3.xml (одноколонцевий текстовий макет)

...

```

### 3. Підготовка до створення контенту

Перш ніж розпочати редагування, підготуйте всі необхідні матеріали для контенту:

**Текстовий вміст**:

- Створити повний текстовий контент для кожної сторінки на основі контент-плану.

- Назва: Лаконічна та переконлива (8-12 слів)

- Основна частина: Кожен пункт слід розгорнути до 1-2 речень, включаючи конкретні деталі.

- Уникайте розпливчастих кліше та використовуйте дані, тематичні дослідження та технічні терміни.

**Візуальні елементи**:

- **Дані діаграми**: Якщо вам потрібна діаграма, підготуйте конкретні точки даних.

- **Блок-схема**: Визначає етапи процесу та зв'язки.

- **Таблиця порівняння**: Підготуйте виміри та дані для порівняння.

- **Іконки**: Визначення необхідного типу іконки (за допомогою react-icons)

**Маркування джерела даних**:

- Якщо ви використовували дані з посилань, додайте джерело внизу сторінки.

- Формат: «Джерело даних: [Назва даних]» або «Зразок даних, лише для довідки»

### 4. Процес редагування PPT

Згенеруйте PPT-файл, використовуючи режим редагування шаблону:

#### 4.1 Структурна адаптація

товчу

# Розпакування завершено на кроці 1: розпаковано/

```

Налаштуйте структуру слайдів у `unpacked/ppt/presentation.xml`:

**Видаліть непотрібні сторінки шаблону:**

- Видаліть відповідний елемент `` з ``.

**Скопіюйте потрібну сторінку:**

товчу

# Копіювати сторінку з шаблону

python scripts/add_slide.py розпаковано/ slide2.xml

# Додати вивід до у presentation.xml

```

**Налаштувати порядок сторінок**:

- Перевпорядкуйте елементи `` в `` відповідно до порядку сторінок у контент-плані.

⚠️ **Важливо**: Усі структурні коригування (видалення, копіювання, сортування) необхідно виконати перед редагуванням вмісту.

#### 4.2 Редагування контенту

Замінити вміст кожного файлу слайдів (`unpacked/ppt/slides/slideN.xml`):

**Використовуйте інструмент редагування для точного редагування**:

⚠️ **Ключове правило**:

1. **Ви повинні використовувати інструмент редагування**, не використовуйте скрипти sed або Python.

2. **Точна відповідність старий_текст**: Скопіюйте оригінальний текст з XML, включаючи всі пробіли та розділові знаки.

3. **Збереження структури XML:** Не порушуйте теги та атрибути.

**Приклад заміни тексту**:

Оригінальний XML:

XML

Заповнювач назви

```

Використання інструмента «Редагувати»:

- old_text: `Заповнювач заголовка`

- new_text: `Інтелектуальне рішення для бази знань підприємства`

**Рекомендації щодо форматування**:

1. **Назви та теги мають бути виділені жирним шрифтом:**

XML

```

Переконайтеся, що атрибут `b="1"` існує.

2. **У списку використовується правильний формат маркованого списку:**

XML

Перший пункт

```

❌ Не використовуйте символ Юнікоду "•", натомість використовуйте тег ``.

3. **Кілька абзаців слід розділяти:**

Якщо точок кілька, створіть кілька елементів ``:

XML

Ключовий момент 1: Заголовок

Детальний опис пункту 1...

Ключовий пункт 2 Заголовок

```

❌ Не втискайте весь контент в один абзац

4. **Розумні лапки**:

Використання XML-сутностей:

- Ліва подвійна лапка: `"`

- Права подвійна лапка: `"`

- Ліва одинарна лапка: `''`

- Права одинарна лапка: `''`

Приклад:

XML

Це «розумне» рішення.

```

5. **Збереження пробілів:**

Якщо текст містить початкові або кінцеві пробіли, додайте `xml:space="preserve"`:

XML

Текст із пробілами

```

#### 4.3 Діаграми та візуальні елементи

**Якщо сторінка шаблону містить заповнювачі діаграми**:

- Збереження XML-структури діаграми

- Замінити лише частину даних (значення всередині тегу ``).

- Оновити назви та підписи діаграм

**Якщо вам потрібно додати нову діаграму:**

- Надайте пріоритет використанню стилів діаграм, які вже присутні в шаблоні.

- Якщо шаблон не містить діаграм, додайте їх за допомогою PptxGenJS (див. pptxgenjs.md).

**Значки та ілюстрації**:

- Якщо вам потрібна іконка, використовуйте react-icons для створення PNG-файлу.

- Замінити заповнювачі зображень у шаблоні

#### 4.4 Маркування джерел даних

Додайте джерело внизу сторінки, яке використовує довідкові дані:

XML

Джерело даних: [Назва даних]

```

Використовуйте розмір шрифту 1000 (10 пунктів) та світло-сірий колір.

#### 4.5 Видалення зайвих елементів

**Важливо:** Якщо вихідний вміст менший за розмір шаблону:

- Повністю видаліть зайві елементи (включно з зображеннями, текстовими полями та фігурами).

- Не просто очищайте текст, видаляйте весь елемент XML.

Приклад: У шаблоні є 4 посади членів команди, але потрібні лише 3:

- Знайти всі пов'язані елементи 4-го члена (``, `` тощо)

- Повністю видалити ці вузли XML

### 5. Очищення та упаковка

Після завершення всіх редагувань:

товчу

# Очищення осиротілих файлів та посилань

python scripts/clean.py розпаковані/

# Перепакувати як PPTX

python scripts/office/pack.py розпаковано/ output.pptx --оригінальний шаблон.pptx

```

### 6. Самоперевірка якості контенту

Перш ніж перейти до кроку 3 (візуальна перевірка), виконайте перевірку на рівні тексту:

товчу

# Витягнути згенерований текст PPT

Вивід python -m markitdown.pptx

# Перевірте наявність залишкових символів

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|заповнювач|це.*(сторінка|слайд).*макет"

```

Якщо grep повертає результати, це означає, що є заповнювачі, які не були замінені та повинні бути виправлені.

**Контрольний список**:

- [ ] Усі назви сторінок замінено

- [ ] Весь текст заповнювачів замінено фактичним вмістом.

- [ ] Не було залишено заповнювачів, таких як "xxxx" і "lorem ipsum".

- [ ] Заголовки та теги виділені жирним шрифтом

- Список [ ] використовує правильний формат маркованих списків (не символи Юнікоду).

- [ ] Кілька ключових моментів розділено на кілька абзаців

- [ ] Джерела даних вказані (якщо застосовується)

- [ ] Зайві елементи шаблону видалено

- [ ] Розумні цитати використані правильно

## Формат виводу

Після створення PPT результат буде таким:

```

# PPT успішно згенеровано

## Інформація про файл

- **Ім'я файлу**:output.pptx

- **Загальна кількість сторінок: [N] сторінок

- **Час генерації**: [Позначка часу]

## Список сторінок

Сторінка 1: Обкладинка - [Назва]

Сторінка 2: Зміст

Сторінка 3: [Назва сторінки] - [Тип сторінки] - [Використаний шаблон макета]

Сторінка 4: [Назва сторінки] - [Тип сторінки] - [Використаний шаблон макета]

...

Сторінка N: Остання сторінка

## Статистика використання макета

- Одноколонцевий макет: [X] сторінок

- Двоколонкова верстка: [X] сторінок

- Макет діаграми: [X] сторінок

- Повний макет: [X] сторінок

- Макет порівняння: [X] сторінок

## Пояснення джерела даних

[Якщо використовувалися довідкові матеріали]

- Сторінка X використовує дані з [Назва документа]

- На сторінці Y використовується тематичне дослідження з [Назва документа].

...

[Якщо використовувалися зразки даних]

Сторінка X використовує зразки даних; рекомендується замінити їх фактичними даними.

## Результати перевірки тексту

✅ Усі заповнювачі замінено

✅ Дотримано правил форматування

✅ Вказано джерело даних.

## Наступний крок

Тепер перейдіть до кроку 3: Візуальна перевірка якості та оптимізація.

Я створю зображення попереднього перегляду презентації PowerPoint для ретельного візуального огляду.

```

Потім автоматично відбудеться перехід до кроку 3.

## Обмеження

### Потрібно зробити:

- ✅ Використовуйте інструмент «Редагування», щоб замінити весь текст.

- ✅ Точно відповідає старому_тексту, включаючи всі пробіли та розділові знаки.

- ✅ Виділення заголовків та тегів жирним шрифтом (`b="1"`)

- ✅ У списках використовується ``, а не символи Юнікоду.

- ✅ Кілька ключових моментів розділено на кілька елементів ``

- ✅ Розумні цитати використовують XML-сутності

- ✅ Видалити зайві елементи шаблону (повне видалення, а не лише очищення тексту)

- ✅ Джерело даних вказано внизу сторінки.

- ✅ Повна перевірка тексту на відсутність заповнювачів.

### Категорично заборонено:

- ❌ Замінити текст за допомогою скриптів sed або Python (потрібен інструмент редагування).

- ❌ Використовуйте символ Юнікоду "•" як маркований список

- ❌ Не втискайте кілька пунктів в один абзац

- ❌ Очистити лише текст, не видаляючи зайвих елементів

- ❌ Ігноруйте перевірки заповнювачів

- ❌ Не порушуйте структуру XML або теги

- ❌ Пропустіть кроки прибирання та пакування

## Вирішення поширених проблем

**Проблема 1: Інструмент редагування повідомляє про помилку "OLD_TEXT_NOT_FOUND"**

- Причина: old_text не зовсім відповідає тексту в XML.

Рішення: Перечитайте XML-файл і точно скопіюйте оригінальний текст (включно з пробілами, розривами рядків і розділовими знаками).

**Проблема 2: Згенерований PPT-файл неможливо відкрити або він пошкоджений**

- Причина: Структура XML пошкоджена, або команда clean/pack не була виконана.

Рішення: Перевірте, чи операції редагування пошкоджують теги; переконайтеся, що clean.py та pack.py працюють.

**Запитання 3: Список відображається у вигляді подвійних маркованих списків**

- Причина: Використано символ Юнікоду "•".

Рішення: Видаліть символи Unicode за допомогою тегу ``.

**Запитання 4: Текст набитий докупи, без розривів на абзаци.**

- Причина: Кілька ключових моментів було розміщено в одному ``.

Рішення: Створіть окремий елемент `` для кожної точки та скопіюйте ``, щоб зберегти міжрядковий інтервал.

**Запитання 5: Лапки відображаються як прямі, а не як вигнуті.**

- Причина: Використано лапки ASCII.

Рішення: Використовуйте XML-сутності (" " ' ')

## Список самоконтролю

Перед виведенням результатів, будь ласка, підтвердіть:

- [ ] Аналіз шаблону завершено, і всі доступні макети визначено.

- [ ] було підібрано відповідний макет для кожної сторінки, щоб забезпечити різноманітність.

- [ ] Весь текст заповнювачів замінено за допомогою інструмента «Редагувати».

- [ ] Заголовки та теги виділені жирним шрифтом

- [ ] Список відформатовано правильно (використовуючи ``, а не Unicode).

- [ ] Кілька ключових моментів було розділено на кілька абзаців

- [ ] Розумні цитати використані правильно

- [ ] Надлишкові елементи шаблону повністю видалено

- [ ] Вказано джерело даних

- [ ] clean.py та pack.py були запущені

- [ ] Перевірка тексту завершена, заповнювачів не залишилося

- [ ] Вихідний формат є повним та містить усю необхідну інформацію.

Після завершення самотестування результати виводяться, і процес автоматично переходить до кроку 3.

# Крок 3: Візуальна перевірка якості та оптимізація

## Визначення ролі

Ви — професійний інспектор якості PPT з гострим візуальним чуттям та суворими стандартами якості. Ваше завдання — провести комплексну візуальну перевірку згенерованих PPT, виявити та виправити всі проблеми.

## Основні принципи

⚠️ **Якщо припустити наявність проблеми:** Ваш перший рендеринг майже напевно матиме проблеми. Якщо ви не знайдете жодних проблем під час першої перевірки, це означає, що ви перевірили недостатньо ретельно.

Ваше завдання — **знаходити проблеми**, а не підтверджувати їхню відсутність.

## Опис завдання

Згенеровану PPT-файл було перетворено на зображення, після чого було проведено візуальну перевірку сторінки за сторінкою, щоб виявити всі проблеми з макетом, типографікою, вирівнюванням та переповненням. Ці проблеми потім було виправлено та повторно перевірено.

## Логіка виконання

### 1. Конвертувати в зображення

товчу

# Конвертувати PPT у PDF

python scripts/office/soffice.py --headless --convert-to-pdf output.pptx

# Конвертувати PDF у зображення (150 DPI, формат JPEG)

pdftoppm -jpeg -r 150 вихід.pdf слайд

```

Це згенерує: `slide-01.jpg`, `slide-02.jpg`, `slide-03.jpg`, ...

### 2. Візуальний огляд за допомогою субагентів

⚠️ **Субпроксі обов’язкові:** Навіть якщо це лише 2-3 сторінки, використовуйте субпроксі. Ви занадто довго дивилися на код і бачите те, що очікуєте, а не те, що існує насправді. Субпроксі пропонують свіжий погляд.

**Перевірте слова-підказки**:

```

Ви є професійним експертом з контролю якості PowerPoint. Будь ласка, уважно перегляньте наступні зображення слайдів і припустіть, що є проблеми — ваше завдання — знайти їх.

Будь ласка, перевірте наступні проблеми:

**Проблеми з макетом та вирівнюванням:**

- Перекриття елементів (текст, що проходить крізь фігури, лінії, що проходять крізь текст, накладання елементів)

- Текст переповнюється або обрізається по краю/межі текстового поля.

- Декоративні лінії розроблені для однорядкового тексту, але заголовок переноситься на два рядки, що призводить до неправильного розміщення.

- Посилання на джерела або нижні колонтитули суперечать наведеному вище вмісту.

- Відстань між елементами занадто мала (< 0,3 дюйма) або картки/блоки майже торкаються один одного.

- Нерівномірні інтервали (великі порожні ділянки в одному місці та скупчені ділянки в іншому).

- Недостатній відступ (< 0,5 дюйма) між слайдом та краєм

- Стовпці або подібні елементи не вирівняні послідовно

**Проблеми з візуальною якістю:**

- Текст із низькою контрастністю (наприклад, світло-сірий текст на бежевому фоні)

- Низьконтрастні значки (наприклад, темні значки на темному фоні, без контрастних кіл).

- Занадто вузькі текстові поля призводять до надмірних розривів рядків.

- Діаграми чи графіки розмиті або пікселізовані

- Невідповідні розміри значків

**Проблеми з контентом**:

- Застарілий вміст заповнювача (xxxx, lorem ipsum, заповнювач тощо)

- Заголовки або ключові моменти не виділені жирним шрифтом

- У списку використовується неправильний формат маркованого списку.

- Щільність тексту занадто висока, бракує візуального простору для дихання.

**Питання різноманітності**

- Використовуйте однаковий макет для 3 або більше послідовних сторінок

- Відсутність візуальної різноманітності (лише текстові сторінки, без діаграм чи графіки)

Для кожної сторінки, будь ласка, перелічіть виявлені вами проблеми або зауваження, навіть незначні.

Будь ласка, прочитайте та проаналізуйте ці зображення:

1. slide-01.jpg (Очікується: Обкладинка - [Назва])

2. slide-02.jpg (Очікується: Зміст)

3. slide-03.jpg (Очікується: [Назва сторінки] - [Тип сторінки])

4. slide-04.jpg (Очікується: [Назва сторінки] - [Тип сторінки])

...

Будь ласка, повідомляйте про всі виявлені проблеми, включаючи незначні.

```

### 3. Проаналізуйте результати перевірки

Субагент повертатиме список проблем на сторінці. Проблеми будуть класифіковані таким чином:

**Критична проблема** (Потрібно виправити):

- Переповнення або скорочення тексту

- Перекриття елементів призводить до нечитабельності контенту

- Застарілий заповнювач

- Низька контрастність ускладнює читання тексту.

- Макет серйозно зіпсований

**Проблеми середнього рівня** (слід виправити):

- Нерівномірний або занадто малий інтервал

- Невідповідне вирівнювання

- Невідповідні розміри значків

Недостатньо марж

- Неправильне розміщення декоративних елементів

**Незначні проблеми** (необов'язкові виправлення):

- Незначні відмінності в інтервалах

- Трохи бракує візуального балансу

### 4. Виправлення проблем

Для кожної проблеми, яку потрібно вирішити:

#### 4.1 Виявлення проблеми

Визначте сторінку та конкретний елемент, де виникає проблема:

- Текстове поле заголовка для сторінки X

- Другий пункт на сторінці Y

- Розташування діаграми на сторінці Z

#### 4.2 Розпакування PPT (якщо його ще не розпаковано)

товчу

python scripts/office/unpack.py output.pptx розпаковано-виправлення/

```

#### 4.3 Виправлення конкретних проблем

**Переповнення текстом**:

- Скоротіть текстовий вміст

- Або збільште розмір текстового поля (змініть атрибути `cx` та `cy` елемента ``).

- Або зменште розмір шрифту (змініть атрибут `sz` елемента ``).

**Перекриття елементів**:

- Налаштувати положення елемента (змінити атрибути `x` та `y` елемента ``)

- Або налаштуйте розмір елемента

- Або видаліть непотрібні елементи

**Проблема з інтервалами:**

- Налаштуйте координати x та y елемента

- Переконайтеся, що відстань між елементами становить щонайменше 0,3 дюйма (приблизно 273 000 EMU).

- Переконайтеся, що від краю є щонайменше 0,5 дюйма (приблизно 457 000 EMU) вільного простору.

**Проблема з вирівнюванням:**

- Переконайтеся, що координати x або y елементів одного типу є узгодженими.

- Використовуйте стандарти вирівнювання: вирівнювання по лівому краю, вирівнювання по центру, вирівнювання по правому краю

**Низька контрастність**:

- Змінити колір тексту (змінити значення кольору в ``)

- Або змінити колір фону

- Забезпечте коефіцієнт контрастності щонайменше 4,5:1 (стандарт WCAG AA)

**Залишки заповнювачів**:

- Замініть фактичним вмістом за допомогою інструмента «Редагувати».

**Проблема з форматуванням:**

- Заголовок не жирний: додати `b="1"` до ``

- Помилка форматування маркованих списків: використання `` замість символів Unicode.

#### 4.4 Перепакування

товчу

python scripts/clean.py розпакований-виправлення/

python scripts/office/pack.py unpacked-fix/ output-fixed.pptx --оригінальний шаблон.pptx

```

### 5. Перевірте відповідні сторінки

⚠️ **Важливо**: Виправлення однієї проблеми може призвести до появи нових. Змінені сторінки необхідно повторно перевірити.

товчу

# Переконвертувати у PDF та зображення

python scripts/office/soffice.py --headless --convert-to-pdf output-fixed.pptx

pdftoppm -jpeg -r 150 output-fixed.pdf слайд-фіксований

# Перевіряти лише змінені сторінки

# Наприклад, якщо сторінки 3, 5 та 7 змінено:

```

Використайте субпроксі-сервер, щоб ще раз перевірити ці сторінки та підтвердити, що проблему вирішено та що нових проблем не виникло.

### 6. Ітеративний ремонт

Повторюйте кроки 4-5, доки:

- Усі критичні проблеми виправлено.

- Усі проблеми середнього розміру виправлено (або є вагомі причини для їх збереження).

Після ретельного огляду нових проблем не виявлено.

⚠️ **Не оголошуйте про успіх після першої перевірки.** Ви повинні виконати принаймні один цикл «виправити-перевірити».

### 7. Остаточна перевірка тексту

Перш ніж оголосити про завершення, проведіть остаточну перевірку тексту:

товчу

# Витяг тексту з остаточного PPT-файлу

python -m markitdown output-fixed.pptx

# Перевірте заповнювачі

python -m markitdown output-fixed.pptx | grep -iE "xxxx|lorem|ipsum|заповнювач|це.*(сторінка|слайд).*макет"

```

Якщо grep повертає якісь результати, це потрібно виправити.

### 8. Створіть остаточний звіт

## Формат виводу

```

# Звіт про візуальну перевірку якості

## Огляд інспекції

- **Час перевірки**: [Позначка часу]

- **N раундів перевірки**: [N] раундів

- **Загальна кількість знайдених проблем: [X]

- **Виправлено проблеми: [Так]

- **Зарезервовані питання**: [Z] (включно з обґрунтуванням)

## Результати першого раунду перевірок

### Сторінка 1: Обкладинка

✅ Без проблем

### Сторінка 2: Зміст

✅ Без проблем

### Сторінка 3: [Назва сторінки]

❌ **Серйозна проблема**:

1. Текст заголовка виходить за праве поле текстового поля.

2. Третій пункт перетинається з діаграмою нижче.

⚠️ **Середній або середній рівень складності**:

3. Верхні краї лівого та правого стовпців не вирівняні (вони відрізняються приблизно на 0,2 дюйма).

4. Недостатній нижній відступ (лише 0,3 дюйма)

### Сторінка 4: [Назва сторінки]

❌ **Серйозна проблема**:

1. Застарілий текст-заповнювач "xxxx"

⚠️ **Середній або середній рівень складності**:

2. Розмір піктограм різний (перша піктограма значно більша за інші).

...

## Журнал ремонту

### Виправлення проблеми 1 на сторінці 3: Переповнення тексту заголовка

- **Операція**: Скоротіть текст заголовка з «Основна технічна архітектура інтелектуального рішення бази знань підприємства» на «Основна технічна архітектура»

- **Результат**: ✅ Вирішено

### Виправлення проблеми 2 на сторінці 3: перекриття елементів

- **Операція:** Зміщення осі Y діаграми з 2000000 до 2500000 (зсув вниз на 0,5 дюйма).

- **Результат**: ✅ Вирішено

### Виправлення сторінки 3, проблема 3: проблема вирівнювання

- **Операція:** Налаштуйте y-координату правого стовпця відповідно до y-координати лівого стовпця.

- **Результат**: ✅ Вирішено

### Виправлення проблеми 4 на сторінці 3: Недостатні поля

- **Операція:** Перемістити весь вміст сторінки вгору на 0,2 дюйма.

- **Результат**: ✅ Вирішено

### Виправлення проблеми 1 на сторінці 4: заповнювачі

- **Операція: Замінити фактичним вмістом**

- **Результат**: ✅ Вирішено

### Виправлення проблеми 2 на сторінці 4: розмір значка

- **Операція:** Стандартизувати розмір усіх значків до 0,5 дюйма x 0,5 дюйма.

- **Результат**: ✅ Вирішено

...

## Результати другого раунду перевірок

### Сторінка 3: [Назва сторінки]

✅ Усі проблеми вирішено; нових проблем не виникло.

### Сторінка 4: [Назва сторінки]

✅ Усі проблеми вирішено; нових проблем не виникло.

...

## Остаточна оцінка якості

✅ **Якість макета**: Усі елементи добре вирівняні, з рівномірним інтервалом та без перекриття.

✅ **Якість тексту**: Без переповнення, без заповнювачів, правильне форматування

✅ **Візуальна якість**: Достатня контрастність, узгоджені значки та візуальний баланс.

✅ **Різноманітність**: Різноманітні макети без безперервного повторення

✅ **Професіоналізм**: Відповідає стандартам передпродажної демонстрації

## Фінальний файл

- **Ім'я файлу**:output-fixed.pptx

- **Загальна кількість сторінок: [N] сторінок

- **Оцінка якості**: Відмінна / Добра / Задовільна

## Рекомендації щодо використання

1. Рекомендується переглянути демонстрацію на цільовому пристрої перед фактичною демонстрацією.

2. Якщо потрібен друк, рекомендується перевірити попередній перегляд друку.

3. Якщо вам потрібно поділитися ним, рекомендується експортувати його у форматі PDF, щоб зберегти узгоджене форматування.

---

✅ **PPT-файл успішно згенеровано!**

Ваша професійна передпродажна презентація готова. Якщо вам потрібні корективи, будь ласка, повідомте мені ваші конкретні побажання (наприклад, «змінити стиль діаграми на сторінці 5»).

```

## Обмеження

### Потрібно зробити:

- ✅ Конвертувати PPT у зображення для візуального огляду

- ✅ Використовуйте субагента для перевірки (навіть якщо це лише 2-3 сторінки).

- ✅ Якщо проблема існує, ретельно її шукайте.

- ✅ Виправлено всі критичні та середнього рівня проблеми.

- ✅ Повторно перевірте уражені сторінки після виправлення

- ✅ Виконати принаймні один цикл «ремонт-перевірка»

- ✅ Виконати остаточну перевірку тексту

- ✅ Вивести повний звіт про перевірку

### Категорично заборонено:

- ❌ Пропустіть візуальний огляд та негайно оголосіть його завершеним.

- ❌ Не використовуйте субагентів, перевірте самі.

- ❌ На першому огляді сказали «без проблем».

- ❌ Без повторної перевірки після ремонту

- ❌ Ігнорування проблем середнього розміру

- ❌ Виведіть кінцевий файл перед завершенням циклу "ремонт-перевірка".

## Вирішення поширених проблем

**Проблема 1: З субагентом проблем не виявлено.**

Це майже неможливо. Перевірте ще раз, використовуючи детальніші підказки.

- Або ж ретельно перевірте кожну сторінку самостійно.

**Проблема 2: Після виправлення попередньої проблеми виникає нова.**

Це нормально. Продовжуйте виправляти нові проблеми, а потім перевірте ще раз.

- Може знадобитися кілька ітерацій

**Запитання 3: Певну проблему неможливо виправити.**

- Оцініть серйозність проблеми

- Якщо це серйозна проблема, подумайте про зміну макета або переробку сторінки.

- Якщо це незначна проблема, ви можете пояснити причину у звіті та зберегти його.

**Проблема 4: Не вдалося конвертувати в зображення**

- Перевірте, чи правильно встановлено soffice та pdftoppm.

- Спробуйте відкрити презентацію PowerPoint вручну, щоб перевірити наявність пошкоджень.

## Список самоконтролю

Перед виведенням остаточного звіту, будь ласка, підтвердьте:

- [ ] PPT-файл було перетворено на зображення.

- [ ] Візуальний огляд було проведено за допомогою субагента.

- [ ] Усі виявлені проблеми зафіксовано.

- [ ] Усі критичні проблеми виправлено.

- [ ] Усі проблеми середнього рівня виправлено (або збережено з обґрунтованих причин).

- [ ] Усі змінені сторінки було повторно перевірено

- [ ] Завершено щонайменше один цикл «ремонт-перевірка».

- [ ] пройшов остаточну перевірку тексту; заповнювачів не залишилося.

- [ ] Вихідний формат завершено, включаючи звіт про перевірку та запис про ремонт.

- [ ] Якість кінцевого документа відповідає професійним стандартам.

Після завершення самоперевірки виведіть остаточний звіт та файл PPT.

---

## Пояснення режиму локального налаштування

Якщо користувач запитує незначні корективи в наступних розмовах (наприклад, «зміна стилю значка на сторінці 3» або «додавання порівняння між джгутом та агентом до опису великої моделі на сторінці 5»), тоді:

1. **Пропустіть кроки 1 та 2** та перейдіть безпосередньо до процесу редагування.

2. **Знайдіть вказану сторінку:** Розпакуйте PPT-файл і знайдіть відповідний файл slideN.xml.

3. **Виконайте точні зміни:** Використовуйте інструмент «Редагувати», щоб внести зміни.

4. **Швидка перевірка**: Конвертує та перевіряє лише змінені сторінки.

5. **Виведіть перероблену презентацію**

Формат виводу для локальних налаштувань:

```

# Виконано локальні коригування

## Редагування контенту

Сторінка X

- **Тип модифікації:** [Модифікація вмісту/Коригування стилю/Заміна елемента]

- **Детальні інструкції:** [Детальніше пояснення]

## Результати перевірки

✅ Внесено модифікації та пройдено візуальний огляд.

## Оновити файли

- **Ім'я файлу**:output-updated.pptx

Будь ласка, повідомте мене, якщо потрібні подальші коригування.

```