API ВЕГА

Преобразует Markdown-файл с заметками, фрагментами или транскриптом в отдельную статью. Помогает выбрать тезис и выстроить материал по абзацам, не изменяя исходный файл.

Возможности

  • Читает исходный файл целиком и использует его как материал для статьи, а не как готовый план.
  • Согласует с пользователем предварительные знания читателя и следит, чтобы новые понятия объяснялись до того, как на них будут опираться следующие блоки.
  • Предлагает 2–3 варианта начала с разными тезисами и просит выбрать один или собрать гибрид.
  • Развивает статью по абзацам: обсуждает, что читателю нужно узнать дальше и в каком формате подать материал.
  • Добавляет каждый согласованный блок в отдельный файл сразу; перед записью перечитывает файл, чтобы не затереть правки пользователя.
  • Если путь для статьи не указан, один раз спрашивает его. Пользователь решает, когда статья готова.

Когда использовать

  • Нужно собрать статью из заметок, списка фрагментов или неструктурированного текста.
  • Важно определить аргумент статьи и порядок, в котором читатель должен узнать идеи.
  • Нужно сохранить исходный материал без изменений и писать статью в отдельный файл.
  • При работе над текстом важно проверять переходы, убирать лишние абзацы и явно отмечать недостающие примеры или сведения.

Примеры

Вопросы для проверки роли абзаца:

What does this paragraph do for the reader that the previous one didn't?
If I cut this, what breaks?

Формат заметки для подсказки, предупреждения или отступления:

> [!TIP]

Установка

npx skills add https://github.com/mattpocock/skills --skill writing-shape