ВяткинАртём
69 lines
4.2 KiB
Markdown
69 lines
4.2 KiB
Markdown
# 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. Первый файл задает краткие правила по репозиторию, второй содержит более детальные требования к тону, фактам и формату вывода.
|
|
|