notion-research-documentation

Research & Documentation от OpenAI — официальный навык для поиска сведений в Notion и превращения контекста из нескольких страниц в структурированный brief, сравнительный материал или отчёт со ссылками на исходные записи. Его задача состоит не в свободном написании текста по памяти, а в последовательном исследовании: сначала находятся релевантные страницы, затем каждая нужная страница загружается, ключевые разделы фиксируются, выводы связываются с цитатами, и только после этого выбирается формат результата. Такой подход подходит для внутреннего исследования, когда ответ должен сохранять происхождение фактов и позволять вернуться к исходному контексту. Базовый маршрут состоит из пяти шагов. Сначала выполняется targeted-поиск в Notion через Notion:search; если результатов несколько, нужно уточнить область и подтвердить, какие записи относятся к задаче. Затем страницы извлекаются через Notion:fetch, а важные разделы и citations записываются в reference/citations.md. После сбора материалов выбирается форма результата: короткий quick brief, summary по одной теме, comparison для вариантов или comprehensive report для глубокого разбора. Синтез должен группировать находки по темам и вопросам, отдельно отмечать факты, ограничения, противоречия и пробелы. При создании страницы используется Notion:notion-create-pages с явным parent и массивом pages; в итоговой странице должны быть заголовок, краткое резюме, ключевые выводы, подтверждающие свидетельства, рекомендации или следующие шаги, ссылки на источники и отдельный раздел references/citations. Навык предусматривает обновление уже существующего отчёта. Перед изменением его нужно получить, а затем использовать Notion:notion-update-page с update_content, пустым объектом properties и парами поиска и замены. Если меняются только свойства, применяется update_properties с content_updates: []; оба верхнеуровневых поля передаются по ожидаемой схемой даже тогда, когда одно не используется. Для новых страниц parent задаётся явно, чтобы результат не оказался в неопределённом месте. Если исследование продолжается, в материал можно добавить highlights, риски, открытые вопросы и связанные задачи, но каждый такой пункт должен быть связан с найденным контекстом, а не с неподтверждённым предположением. Ограничения и защитные правила являются частью назначения навыка. Доступность инструментов Notion может зависеть от подключённого рабочего пространства; если вызов сообщает, что инструмент не найден, его не следует повторять с другими параметрами, а задачу нужно остановить до подключения приложения и авторизации. Для поиска используется один буквальный запрос за вызов и filters: {}, если более узкий фильтр не нужен. В Notion:fetch разрешены только URL или идентификаторы страниц, баз данных и data sources Notion: результат поиска может содержать внешние connected-source URL, которые нельзя передавать этому вызову. Навык не обещает доступ к произвольным внешним материалам и не отменяет проверку области исследования. Цитаты и ссылки должны оставаться в документе, а несогласованности и открытые вопросы — быть явно помечены перед передачей отчёта пользователю. Карточка особенно полезна для подготовки внутреннего брифа по нескольким документам, сравнительной записки по вариантам, исследовательского резюме одной темы, подробного отчёта с рекомендациями и последующего обновления такого отчёта по мере появления новых страниц. Главный результат — воспроизводимая связь «найденная страница — утверждение — раздел итогового документа», а не просто длинный текст. Поэтому качество работы определяется полнотой найденного пространства, корректностью citations и явностью границ исследования; сам навык требует действующего Notion-доступа и не должен скрывать отсутствие источников за шаблонными формулировками.