> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Набор навыков консультанта по питанию

> Маршрутизация пищевых данных, научных источников и медицинских ограничений для личности «Консультант по питанию».

# Набор навыков консультанта по питанию

Набор разделяет три разных вопроса:

1. что содержится в продукте;
2. что показывают исследования и действующие рекомендации;
3. что подходит конкретному человеку.

Пищевая база отвечает только на первый вопрос. Переход к индивидуальному совету требует контекста, применимого источника и, в клинических случаях, профильного специалиста. Общие границы закреплены в `SOUL.md` личности [«Консультант по питанию»](/nutrition_adviser_ru), поэтому они действуют даже без загрузки отдельного навыка.

## `pp-nutrition`

Навык используется для обычных продуктов и блюд:

* поиск макро- и микронутриентов в USDA FoodData Central;
* сравнение двух–пяти продуктов на 100 г, порцию или 100 ккал;
* суммирование состава блюда по известным продуктам и массе;
* ссылка на конкретную запись USDA.

Перед расчётом уточняются состояние продукта, способ приготовления, съедобная масса, единица и марка, если она меняет состав. Результат содержит основу сравнения, источник, идентификатор записи, дату доступа и ограничения.

Навык использует собственный скрипт `scripts/nutrition_lookup.py` на стандартной библиотеке Python. Он поддерживает поиск, получение записи, сравнение на 100 г или 100 ккал, расчёт блюда и формирование ссылки на источник. Поиск ограничен 25 результатами, сравнение — пятью продуктами, блюдо — двадцатью компонентами, ответ — 8 МиБ, а один запрос — 20 секундами.

Необязательный бесплатный `FDC_API_KEY` повышает лимит USDA; без него скрипт использует общий демонстрационный ключ. Ключ поступает только из зашифрованных секретов Велеса. В скрипте нет пищевого дневника, профилей, собственной доставки в файл или вебхук, отправки отзывов, кэша и локального хранения учётных данных.

## `pp-open-food-facts`

Навык используется для известного упакованного продукта:

* получение записи по штрихкоду;
* чтение состава, заявленных аллергенов и возможных следов;
* просмотр добавок, пищевой ценности, Nutri-Score и NOVA;
* ограниченное сравнение нескольких товаров;
* проверка страны, марки и качества записи.

Навык использует собственный скрипт `scripts/open_food_facts.py` на стандартной библиотеке Python и не требует ключа для чтения. Он принимает только штрихкоды из 8–14 цифр, ограничивает поиск десятью товарами, сравнение — пятью товарами, ответ — 8 МиБ, а один запрос — 20 секундами. Изменение карточки товара, загрузка изображений, вход в учётную запись и массовое извлечение не реализованы.

Open Food Facts наполняется сообществом. Пустое поле аллергенов не доказывает отсутствие аллергена, а запись другой страны или размера упаковки может относиться к иной рецептуре. Значимые сведения сверяются с текущей этикеткой.

## Медицинские и научные навыки

Когда вопрос выходит за пределы состава продукта, используется наиболее узкий подходящий навык:

| Навык | Когда применяется |
| - | - |
| `medical-evidence-review` | Заболевание, особая группа, лечебное вмешательство или значимый исход для здоровья. |
| `entrez-search` | Нужен поиск публикаций и записей NCBI. |
| `medical-lab-results` | Пользователь предоставляет лабораторный отчёт. |
| `medication-reconciliation` | Нужно сверить лекарства, добавки, аллергии и возможные расхождения. |
| `medical-symptom-navigation` | Есть симптомы или вопрос о срочности обращения. |

Эти навыки не запускаются все одновременно. Состав продукта не требует обзора литературы, а клинически значимый совет нельзя обосновывать только пищевой базой.

## Установка и область действия

Исходники находятся в репозитории `https://github.com/alor-broker/skills`. Для личности каталоги копируются в:

```text theme={null}
<рабочая-область>/personalities/nutrition-adviser/skills/<имя-навыка>/
```

Размещение в каталоге личности не добавляет специализированную маршрутизацию всем остальным личностям. Установленные копии являются пользовательскими и не обновляются автоматически вместе с исходным репозиторием.

Два навыка пищевых баз адаптированы из `mvanhorn/printing-press-library` на версии `829c1619a79b5a91d3e3b03cd9fbb43e5355b0b3`. В каждом `SKILL.md` сохранены автор, лицензия, ссылка на исходник и ограничения адаптации. Внешние программы заменены двумя встроенными скриптами общим объёмом менее 1000 строк.

## Проверяемые ограничения

* Возможная угроза жизни обрабатывается до опроса, расчётов и поиска.
* Пищевая база не выдаётся за источник лечебного назначения.
* Полученные значения USDA отделяются от локальных расчётов и интерпретации.
* Сведения Open Food Facts сопровождаются предупреждением о данных сообщества и сверкой с упаковкой.
* Фотография еды не считается точным измерением порции.
* Лекарства и лечебный рацион не меняются по ответу навыка.
* Клинически значимые выводы учитывают страну, дату, группу людей и действующий источник.
* Собственный дневник программ и внешняя отправка данных не используются; долговременное состояние принадлежит Велесу.
* Личность не обещает анонимность или изолированную медицинскую память.

## Связанные страницы

* [Консультант по питанию](/nutrition_adviser_ru)
* [Набор медицинских навыков](/skills/medical_suite_ru)
* [Навыки Велеса: подробный справочник](/skills/reference_ru)
* [Поиск в NCBI](/skills/entrez_search_ru)
* [Секреты и токены](/basics/secrets_ru)