| name | blog-draft |
| description | Створення чернетки блог-посту з ідей та ресурсів. Використовуйте, коли користувачі хочуть написати блог-пост, створити контент з дослідження або підготувати статтю. Проводить через дослідження, мозковий штурм, складання плану та ітеративне написання з контролем версій. |
Введення користувача
$ARGUMENTS
Ви ПОВИННІ врахувати введення користувача перед продовженням. Користувач має надати:
- Ідея/Тема: Основна концепція або тематика блог-посту
- Ресурси: URL, файли або посилання на дослідження (необовʼязково, але рекомендовано)
- Цільова аудиторія: Для кого блог-пост (необовʼязково)
- Тон/Стиль: Формальний, невимушений, технічний тощо (необовʼязково)
ВАЖЛИВО: Якщо користувач запитує оновлення існуючого блог-посту, пропустіть кроки 0-8 і починайте безпосередньо з Кроку 9. Спочатку прочитайте існуючий файл(и) чернетки, потім продовжуйте з процесом ітерації.
Потік виконання
Виконуйте ці кроки послідовно. Не пропускайте кроки та не продовжуйте без затвердження користувача, де це зазначено.
Крок 0: Створення папки проєкту
-
Згенерувати назву папки у форматі: YYYY-MM-DD-short-topic-name
- Використати сьогоднішню дату
- Створити короткий, URL-дружній slug з теми (малі літери, дефіси, макс. 5 слів)
-
Створити структуру папок:
blog-posts/
└── YYYY-MM-DD-short-topic-name/
└── resources/
-
Підтвердити створення папки з користувачем перед продовженням.
Крок 1: Дослідження та збір ресурсів
-
Створити підпапку resources/ у каталозі блог-посту
-
Для кожного наданого ресурсу:
- URL-адреси: Отримати та зберегти ключову інформацію до
resources/ як markdown-файли
- Файли: Прочитати та підсумувати в
resources/
- Теми: Використати веб-пошук для збору актуальної інформації
-
Для кожного ресурсу створити файл резюме в resources/:
resources/source-1-[short-name].md
resources/source-2-[short-name].md
- тощо
-
Кожне резюме має включати:
# Джерело: [Назва/URL]
## Ключові тези
- Теза 1
- Теза 2
## Релевантні цитати/дані
- Цитата або статистика 1
- Цитата або статистика 2
## Як це стосується теми
Короткий опис релевантності
-
Представити резюме дослідження користувачу.
Крок 2: Мозковий штурм та уточнення
-
На основі ідеї та досліджених ресурсів представити:
- Основні теми, виявлені з дослідження
- Потенційні ракурси для блог-посту
- Ключові тези, які слід розкрити
- Прогалини в інформації, що потребують уточнення
-
Поставити уточнюючі запитання:
- Який головний висновок ви хочете донести до читачів?
- Чи є конкретні тези з дослідження, які хочете виділити?
- Яка цільова довжина? (коротка: 500-800 слів, середня: 1000-1500, довга: 2000+)
- Щось хочете виключити?
-
Чекати відповідей користувача перед продовженням.
Крок 3: Запропонувати план
-
Створити структурований план, що включає:
# План блог-посту: [Назва]
## Метаінформація
- **Цільова аудиторія**: [хто]
- **Тон**: [стиль]
- **Цільова довжина**: [кількість слів]
- **Головний висновок**: [ключове повідомлення]
## Запропонована структура
### Зачіпка/Вступ
- Ідея вступної зачіпки
- Встановлення контексту
- Теза
### Розділ 1: [Назва]
- Ключова теза A
- Ключова теза B
- Підтверджуючі докази з [джерела]
### Розділ 2: [Назва]
- Ключова теза A
- Ключова теза B
[Продовжити для всіх розділів...]
### Висновок
- Резюме ключових тез
- Заклик до дії або завершальна думка
## Джерела для цитування
- Джерело 1
- Джерело 2
-
Представити план користувачу та запитати затвердження або модифікації.
Крок 4: Зберегти затверджений план
-
Після затвердження плану користувачем зберегти його як OUTLINE.md у папці блог-посту.
-
Підтвердити збереження плану.
Крок 5: Закомітити план (якщо в git-репо)
-
Перевірити, чи поточний каталог є git-репозиторієм.
-
Якщо так:
- Додати нові файли до індексу: папку блог-посту, ресурси та OUTLINE.md
- Створити коміт з повідомленням:
docs: Add outline for blog post - [topic-name]
- Відправити на віддалений сервер
-
Якщо не git-репо, пропустити цей крок та повідомити користувача.
Крок 6: Написати чернетку
-
На основі затвердженого плану написати повну чернетку блог-посту.
-
Точно дотримуватися структури з OUTLINE.md.
-
Включити:
- Захопливий вступ із зачіпкою
- Чіткі заголовки розділів
- Підтверджуючі докази та приклади з дослідження
- Плавні переходи між розділами
- Сильний висновок з головною тезою
- Цитування: Усі порівняння, статистика, дані та фактичні твердження ПОВИННІ цитувати оригінальне джерело
-
Зберегти чернетку як draft-v0.1.md у папці блог-посту.
-
Формат:
# [Назва блог-посту]
*[Необовʼязково: підзаголовок або слоган]*
[Повний вміст з інлайн-цитатами...]
---
## Список джерел
- [1] Назва джерела 1 - URL або цитата
- [2] Назва джерела 2 - URL або цитата
- [3] Назва джерела 3 - URL або цитата
-
Вимоги до цитування:
- Кожна точка даних, статистика або порівняння ПОВИННІ мати інлайн-цитату
- Використовуйте нумеровані посилання [1], [2] тощо, або іменовані цитати [Назва джерела]
- Звʼязуйте цитати з розділом Список джерел наприкінці
- Приклад: «Дослідження показують, що 65% розробників віддають перевагу TypeScript [1]»
- Приклад: «React перевершує Vue за швидкістю рендерингу на 20% [React Benchmarks 2024]»
Крок 7: Закомітити чернетку (якщо в git-репо)
-
Перевірити, чи в git-репозиторії.
-
Якщо так:
- Додати файл чернетки до індексу
- Створити коміт з повідомленням:
docs: Add draft v0.1 for blog post - [topic-name]
- Відправити на віддалений сервер
-
Якщо не git-репо, пропустити та повідомити користувача.
Крок 8: Представити чернетку для перегляду
-
Представити вміст чернетки користувачу.
-
Запитати зворотний звʼязок:
- Загальне враження?
- Розділи, що потребують розширення або скорочення?
- Потрібні корекції тону?
- Відсутня інформація?
- Конкретні правки або переписування?
-
Чекати відповіді користувача.
Крок 9: Ітерація або фіналізація
Якщо користувач запитує зміни:
- Зафіксувати всі запитані модифікації
- Повернутися до Кроку 6 з такими змінами:
- Збільшити номер версії (v0.2, v0.3 тощо)
- Врахувати всі зауваження
- Зберегти як
draft-v[X.Y].md
- Повторити Кроки 7-8
Якщо користувач затверджує:
- Підтвердити фінальну версію чернетки
- За бажанням перейменувати на
final.md
- Підсумувати процес створення блог-посту:
- Загальна кількість створених версій
- Ключові зміни між версіями
- Фінальна кількість слів
- Створені файли
Відстеження версій
Усі чернетки зберігаються з інкрементальним версіонуванням:
draft-v0.1.md — початкова чернетка
draft-v0.2.md — після першого раунду зауважень
draft-v0.3.md — після другого раунду зауважень
- тощо
Це дозволяє відстежувати еволюцію блог-посту та повертатися до попередніх версій за потреби.
Структура вихідних файлів
blog-posts/
└── YYYY-MM-DD-topic-name/
├── resources/
│ ├── source-1-name.md
│ ├── source-2-name.md
│ └── ...
├── OUTLINE.md
├── draft-v0.1.md
├── draft-v0.2.md (якщо ітерації)
└── draft-v0.3.md (якщо більше ітерацій)
Поради щодо якості
- Зачіпка: Починайте з питання, дивовижного факту або знайомого сценарію
- Потік: Кожен абзац має зʼєднуватися з наступним
- Докази: Підтверджуйте твердження даними з дослідження
- Цитування: ЗАВЖДИ цитуйте джерела для:
- Усіх статистик та даних (напр., «За даними [Джерело], 75%...»)
- Порівнянь між продуктами, сервісами або підходами (напр., «X працює у 2 рази швидше за Y [Джерело]»)
- Фактичних тверджень про ринкові тенденції, результати досліджень або бенчмарки
- Використовуйте інлайн-цитати у форматі: [Назва джерела] або [Автор, Рік]
- Голос: Підтримуйте послідовний тон протягом усього тексту
- Довжина: Дотримуйтесь цільової кількості слів
- Читабельність: Використовуйте короткі абзаци, маркери де доречно
- CTA: Завершуйте чітким закликом до дії або питанням, що провокує думки
Примітки
- Завжди чекайте затвердження користувача у зазначених контрольних точках
- Зберігайте всі версії чернеток для історії
- Використовуйте веб-пошук для актуальної інформації, коли надані URL
- Якщо ресурсів недостатньо, попросіть користувача надати більше або запропонуйте додаткове дослідження
- Адаптуйте тон відповідно до цільової аудиторії (технічна, загальна, бізнес тощо)