blog-draft 精选

Введення користувача

$ARGUMENTS

Ви ПОВИННІ врахувати введення користувача перед продовженням. Користувач має надати:

• Ідея/Тема: Основна концепція або тематика блог-посту
• Ресурси: URL, файли або посилання на дослідження (необовʼязково, але рекомендовано)
• Цільова аудиторія: Для кого блог-пост (необовʼязково)
• Тон/Стиль: Формальний, невимушений, технічний тощо (необовʼязково)

ВАЖЛИВО: Якщо користувач запитує оновлення існуючого блог-посту, пропустіть кроки 0-8 і починайте безпосередньо з Кроку 9. Спочатку прочитайте існуючий файл(и) чернетки, потім продовжуйте з процесом ітерації.

Потік виконання

Виконуйте ці кроки послідовно. Не пропускайте кроки та не продовжуйте без затвердження користувача, де це зазначено.

Крок 0: Створення папки проєкту

1. Згенерувати назву папки у форматі: YYYY-MM-DD-short-topic-name

• Використати сьогоднішню дату
• Створити короткий, URL-дружній slug з теми (малі літери, дефіси, макс. 5 слів)

1. Створити структуру папок:

   blog-posts/
   └── YYYY-MM-DD-short-topic-name/
       └── resources/

1. Підтвердити створення папки з користувачем перед продовженням.

Крок 1: Дослідження та збір ресурсів

1. Створити підпапку resources/ у каталозі блог-посту

1. Для кожного наданого ресурсу:

• URL-адреси: Отримати та зберегти ключову інформацію до resources/ як markdown-файли
• Файли: Прочитати та підсумувати в resources/
• Теми: Використати веб-пошук для збору актуальної інформації

1. Для кожного ресурсу створити файл резюме в resources/:

• resources/source-1-[short-name].md
• resources/source-2-[short-name].md
• тощо

1. Кожне резюме має включати:

   # Джерело: [Назва/URL]

   ## Ключові тези
   - Теза 1
   - Теза 2

   ## Релевантні цитати/дані
   - Цитата або статистика 1
   - Цитата або статистика 2

   ## Як це стосується теми
   Короткий опис релевантності

1. Представити резюме дослідження користувачу.

Крок 2: Мозковий штурм та уточнення

1. На основі ідеї та досліджених ресурсів представити:

• Основні теми, виявлені з дослідження
• Потенційні ракурси для блог-посту
• Ключові тези, які слід розкрити
• Прогалини в інформації, що потребують уточнення

1. Поставити уточнюючі запитання:

• Який головний висновок ви хочете донести до читачів?
• Чи є конкретні тези з дослідження, які хочете виділити?
• Яка цільова довжина? (коротка: 500-800 слів, середня: 1000-1500, довга: 2000+)
• Щось хочете виключити?

1. Чекати відповідей користувача перед продовженням.

Крок 3: Запропонувати план

1. Створити структурований план, що включає:

   # План блог-посту: [Назва]

   ## Метаінформація
   - **Цільова аудиторія**: [хто]
   - **Тон**: [стиль]
   - **Цільова довжина**: [кількість слів]
   - **Головний висновок**: [ключове повідомлення]

   ## Запропонована структура

   ### Зачіпка/Вступ
   - Ідея вступної зачіпки
   - Встановлення контексту
   - Теза

   ### Розділ 1: [Назва]
   - Ключова теза A
   - Ключова теза B
   - Підтверджуючі докази з [джерела]

   ### Розділ 2: [Назва]
   - Ключова теза A
   - Ключова теза B

   [Продовжити для всіх розділів...]

   ### Висновок
   - Резюме ключових тез
   - Заклик до дії або завершальна думка

   ## Джерела для цитування
   - Джерело 1
   - Джерело 2

1. Представити план користувачу та запитати затвердження або модифікації.

Крок 4: Зберегти затверджений план

1. Після затвердження плану користувачем зберегти його як OUTLINE.md у папці блог-посту.

1. Підтвердити збереження плану.

Крок 5: Закомітити план (якщо в git-репо)

1. Перевірити, чи поточний каталог є git-репозиторієм.

1. Якщо так:

• Додати нові файли до індексу: папку блог-посту, ресурси та OUTLINE.md
• Створити коміт з повідомленням: docs: Add outline for blog post - [topic-name]
• Відправити на віддалений сервер

1. Якщо не git-репо, пропустити цей крок та повідомити користувача.

Крок 6: Написати чернетку

1. На основі затвердженого плану написати повну чернетку блог-посту.

1. Точно дотримуватися структури з OUTLINE.md.

1. Включити:

• Захопливий вступ із зачіпкою
• Чіткі заголовки розділів
• Підтверджуючі докази та приклади з дослідження
• Плавні переходи між розділами
• Сильний висновок з головною тезою
• Цитування: Усі порівняння, статистика, дані та фактичні твердження ПОВИННІ цитувати оригінальне джерело

1. Зберегти чернетку як draft-v0.1.md у папці блог-посту.

1. Формат:

   # [Назва блог-посту]

   *[Необовʼязково: підзаголовок або слоган]*

   [Повний вміст з інлайн-цитатами...]

   ---

   ## Список джерел
   - [1] Назва джерела 1 - URL або цитата
   - [2] Назва джерела 2 - URL або цитата
   - [3] Назва джерела 3 - URL або цитата

1. Вимоги до цитування:

• Кожна точка даних, статистика або порівняння ПОВИННІ мати інлайн-цитату
• Використовуйте нумеровані посилання [1], [2] тощо, або іменовані цитати [Назва джерела]
• Звʼязуйте цитати з розділом Список джерел наприкінці
• Приклад: «Дослідження показують, що 65% розробників віддають перевагу TypeScript [1]»
• Приклад: «React перевершує Vue за швидкістю рендерингу на 20% [React Benchmarks 2024]»

Крок 7: Закомітити чернетку (якщо в git-репо)

1. Перевірити, чи в git-репозиторії.

1. Якщо так:

• Додати файл чернетки до індексу
• Створити коміт з повідомленням: docs: Add draft v0.1 for blog post - [topic-name]
• Відправити на віддалений сервер

1. Якщо не git-репо, пропустити та повідомити користувача.

Крок 8: Представити чернетку для перегляду

1. Представити вміст чернетки користувачу.

1. Запитати зворотний звʼязок:

• Загальне враження?
• Розділи, що потребують розширення або скорочення?
• Потрібні корекції тону?
• Відсутня інформація?
• Конкретні правки або переписування?

1. Чекати відповіді користувача.

Крок 9: Ітерація або фіналізація

Якщо користувач запитує зміни:

1. Зафіксувати всі запитані модифікації
2. Повернутися до Кроку 6 з такими змінами:

• Збільшити номер версії (v0.2, v0.3 тощо)
• Врахувати всі зауваження
• Зберегти як draft-v[X.Y].md
• Повторити Кроки 7-8

Якщо користувач затверджує:

1. Підтвердити фінальну версію чернетки
2. За бажанням перейменувати на final.md
3. Підсумувати процес створення блог-посту:

• Загальна кількість створених версій
• Ключові зміни між версіями
• Фінальна кількість слів
• Створені файли

Відстеження версій

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

• 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
• Якщо ресурсів недостатньо, попросіть користувача надати більше або запропонуйте додаткове дослідження
• Адаптуйте тон відповідно до цільової аудиторії (технічна, загальна, бізнес тощо)