Zotero Analytical Workflow Skills
Семь скиллов и скрипты для цепочки Zotero, полный текст через MinerU, аналитические заметки в Obsidian и поиск по литературе
- 729 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скиллы читают локальную базу Zotero и пишут заметки и полные тексты в хранилище, а конвертер запускает внешнюю утилиту.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/zotero-analytical-workflow-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скиллы читают локальную базу Zotero и пишут заметки и полные тексты в хранилище, а конвертер запускает внешнюю утилиту.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор ведет статью по цепочке Zotero, полный текст через MinerU, аналитическая заметка, база знаний и поиск по литературе. Семь скиллов делят работу: `zotero-data-fetcher` достает метаданные, аннотации и текст по ключу записи Zotero, `zotero-fulltext-archiver` переносит конвертированный PDF в хранилище, `zotero-analytical-writer` пишет заметку, `zotero-collection-manager` ведет разбор коллекции порциями с возобновлением после сбоя. Еще три относятся к хранилищу: оркестратор приема одной статьи, сопровождение базы знаний и поиск по литературе. Хранилище исследования устроено одинаково: `01knowledge/` для знаний, `02vault/` для заметок, `03fulltext/` для полных текстов и папка шаблонов. Скрипт `tools/init_vault.py` создает недостающие каталоги и шаблоны и ничего не трогает в уже существующих файлах. Чтение Zotero идет через локальную базу SQLite только на чтение, а конвертацию PDF запускает необязательная утилита MinerU с таймаутом и проверкой, что Markdown не пуст. Валидаторы проверяют схему страниц знаний, ключи Zotero, взаимные ссылки между заметкой и полным текстом и размещение файлов. Скиллы запускаются из Codex и совместимых агентов, единой команды на весь процесс нет.
Для кого. Исследователям и аспирантам, которые ведут библиотеку статей в Zotero и заметки в Obsidian и хотят, чтобы агент разбирал статьи с проверкой по полному тексту.
Подходит, если
- В коллекции Zotero накопились статьи без разбора, и их надо превращать в аналитические заметки порциями
- К заметке нужен полный текст в Markdown, а PDF лежит во вложениях Zotero
- Прерванный разбор коллекции должен продолжиться с места остановки
- Вопрос по литературе нужно решить через заметки с переходом к полному тексту и возвратом к PDF для проверки
- Перед изменением хранилища надо проверить ссылки между заметкой и полным текстом валидатором
Не подходит, если
- Нужно переводить или кратко пересказывать статью: скилл извлечения данных не переводит и не заменяет полный текст
- Zotero и Obsidian не используются: цепочка рассчитана на их структуру и ключи
- Нужен один запуск без настройки: перед работой надо создать хранилище и указать пути в `config.toml`
- Нужна сводка по чужой библиотеке без доступа к ее файлам: данные берутся только из локальной базы Zotero
Пример запроса к агенту
Добавь в хранилище статью с ключом Zotero ABCD1234: достань метаданные и PDF, подготовь полный текст и напиши аналитическую заметку.Ограничения
Нужен Python 3.11 или новее, встроенные скрипты используют только стандартную библиотеку. Для чтения локальной базы нужен Zotero Desktop, MinerU и ripgrep необязательны. База Zotero может быть заблокирована, пока идет синхронизация, тогда закройте Zotero и повторите.
Скиллы задуманы как набор для агента, единой программы здесь нет. Процесс идет статья за статьей с проверкой на каждом шаге. Хранилище нового образца использует каталоги `01knowledge/`, `02vault/` и `03fulltext/`, старые раскладки переносятся вручную после резервной копии.
Автор указывает, что версия получила упаковку скиллов, но кросс-платформенной приемки на живом профиле Zotero не имела. Описание сценариев в основном на английском, часть шаблонов и названий каталогов китайские. Ни базы Zotero, ни PDF, ни ключей в репозитории нет.
Как отключить. Удалите папки скиллов из каталога скиллов агента. Хранилище исследования и файл `config.toml` остаются у вас, скиллы их не удаляют.
Частые вопросы
С чего начать работу?
Клонируйте репозиторий, создайте окружение Python 3.11 и выполните `python tools/init_vault.py --vault-root <путь>`. Затем впишите пути к Zotero и MinerU в `config.toml` и запустите `python tools/check_environment.py`.
Меняет ли набор мою базу Zotero?
Нет. Помощник читает локальную базу SQLite только на чтение и ничего в ней не правит.
Нужен ли MinerU?
Только для конвертации PDF в Markdown. Его ставят отдельно и указывают путь к исполняемому файлу в конфигурации.
Как проверить хранилище?
Валидаторами `validate_research_vault_knowledge.py` и `validate_research_vault_literature_links.py`. Оба работают только на чтение.
Есть ли отдельный скилл поиска по литературе?
Да, он вынесен в репозиторий Research-Vault-Literature-Retrieval, а каноническая версия лежит и в этом наборе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПлагин для научной работы: десятки скиллов для обзора литературы, экспериментов, анализа данных и написания статей
CLI строит локальный индекс заметок с «катализаторами», вопросами по вашим записям, чтобы агент находил нужное лучше grep
Хранилище Obsidian со скиллами для рабочих встреч: транскрипты из Gmail, участники, задачи и недельные итоги.
Плагин и набор скиллов, которые превращают хранилище Obsidian в базу знаний с источниками, связями и ответами по ней
Восемь скиллов Claude Code для Obsidian: заметки Granola, NotebookLM, задачи TaskNotes, память о сессиях, выгрузка диалогов
Скиллы для Obsidian
Obsidian Skills
Скиллы для работы агента с Obsidian: Markdown с викиссылками, Bases, JSON Canvas, Obsidian CLI, Defuddle и Knap
Коротко о README
В документации описаны требования, установка, конфигурация, схема хранилища, быстрый старт с помощниками для Zotero и MinerU, перенос со старых раскладок и таблица устранения неполадок. Тесты запускаются без живого профиля Zotero.