Files

4.2 KiB

sell-home

Репозиторий для подготовки и улучшения объявлений о продаже загородной недвижимости на основе разрозненных заметок собственника.

Проект превращает факты из папки draft в готовые тексты для публикации в Avito и CIAN, а также хранит финальные варианты в папке result.

Что делает проект

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

Структура

  • draft/ — исходные заметки и черновые факты об объекте;
  • result/ — готовые тексты объявлений;
  • .github/copilot-instructions.md — правила работы агента в этом репозитории;
  • .github/agents/ — специализированные режимы для генерации и ревью объявлений;
  • .github/skills/ — прикладные навыки для консолидации фактов, написания текста и экспорта результата.

Текущий workflow

  1. Прочитать все релевантные материалы в draft/.
  2. Собрать проверенные факты в целостную картину объекта.
  3. Отделить подтвержденные сведения от мягких маркетинговых интерпретаций.
  4. Подготовить три версии объявления:
    • aggressive;
    • calm;
    • classic.
  5. При необходимости сравнить варианты, выбрать лучший базовый текст и сделать усиленную версию best.
  6. Сохранить итоговые файлы в result/ в обычном текстовом формате.

Требования к текстам

  • язык публикации — русский;
  • голос — от лица собственника, а не агентства;
  • подача — конкретная, теплая, честная, без пустых брокерских штампов;
  • допускаются только те преимущества, которые опираются на исходные заметки;
  • нельзя придумывать характеристики, расстояния, юридические детали или состояние объекта.

Именование файлов

Рекомендуемый формат имени:

location-object-type-variant.txt

Пример:

plaskinino-snt-utenok-house-best.txt

Если файл с нужным именем уже существует, следует создавать версию с новым суффиксом, а не перезаписывать результат молча.

Что уже есть в репозитории

В result/ уже лежат четыре варианта объявления по одному объекту:

  • aggressive;
  • calm;
  • classic;
  • best.

Это удобно использовать как образец структуры, тона и степени конкретики для следующих объектов.

Для работы с AI-агентами

Если вы используете Copilot или другого агента внутри редактора, ориентируйтесь на инструкции из AGENTS.md и .github/copilot-instructions.md. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода.