| name | update-docs-after-feature-change |
| description | Обновляет пользовательскую документацию на русском языке после изменений в продукте, интерфейсе или сценариях. |
Обновление документации после изменений в продукте
Когда использовать
Используй этот skill, когда:
- изменилась функция продукта
- поменялись тексты в интерфейсе
- изменился пользовательский сценарий
- появились новые ограничения
- нужно понять, какие статьи документации устарели
Цель
Найти затронутые статьи и обновить их так, чтобы документация снова была точной, понятной и полезной для пользователя.
Основные требования
- Пиши на русском языке.
- Смотри на изменения глазами пользователя.
- Проверяй, что именно поменялось в сценарии, а не только в коде.
- Не ограничивайся заменой названия кнопки, если изменился сам порядок действий.
- Не выдумывай новые возможности без подтверждения в коде.
Как работать
- Проанализируй изменения в коде, маршрутах, интерфейсных текстах, формах, модальных окнах и сценариях.
- Определи, какие пользовательские статьи это затрагивает.
- Для каждой такой статьи проверь:
- не изменился ли порядок действий
- не поменялись ли названия кнопок, разделов и полей
- не появились ли новые ограничения
- не исчезли ли старые шаги
- не появились ли новые ошибки или состояния
- Обнови текст статьи так, чтобы он оставался понятным пользователю.
- Если статья больше не соответствует продукту, пометь, что её нужно серьёзно переработать или разделить.
Что должно быть в результате
Верни:
- Список затронутых статей
- Краткое описание, что именно в них устарело
- Обновлённые версии статей или конкретные правки
- Отдельный список мест, где нужна дополнительная проверка по UI или скриншотам
Как писать правки
- Не пиши сухо в стиле "обновлено согласно diff".
- Переписывай статью так, будто пользователь читает её впервые.
- Сохраняй ясность и естественный русский язык.
- Если изменение маленькое, не усложняй статью без причины.
- Если изменение большое, пересобери структуру статьи целиком.
Особое правило
Если после изменений поведение стало неочевидным или противоречивым, не скрывай это.
Отдельно укажи, что документация требует уточнения по продукту или интерфейсу.
