potato-skill: Быстрый старт с агентом для программирования
Опишите Claude Code, какие данные должны разметить люди. potato-skill спроектирует исследование, соберёт его как задачу разметки Potato с собственным интерфейсом и запустит.
Начать проект в Potato можно двумя способами. Можно написать задачу самостоятельно, как показано в быстром старте, или описать исследование агенту для программирования и поручить potato-skill спроектировать и собрать его. Эта страница посвящена второму способу. Оба ведут к одному результату: задаче разметки в Potato, которую можно запускать, менять и передавать другим.
Решения по дизайну, которые принимает навык
potato-skill — это навык агента (agent skill): пакет инструкций и вспомогательных скриптов, который агент для программирования загружает, когда этого требует запрос. Он берёт на себя и проектирование исследования, и его сборку, от набора меток до экспортированных данных:
- что спрашивать у разметчиков и по какой шкале
- сколько разметчиков нужно на каждый элемент
- как обучать разметчиков и проверять их работу
- интерфейс, который видят разметчики
- запуск задачи и её прохождение так, как это сделал бы разметчик
- экспорт результатов в формате, нужном следующему шагу
Он работает и с исследованиями, которые уже идут: сообщает о прогрессе и согласованности и говорит, какие изменения безопасны после того, как разметчики начали работу.
Собранная задача работает на Potato, поэтому получает всё, что Potato уже умеет: вход для каждого разметчика, несколько разметчиков на элемент, статистику согласованности, интеграцию с Prolific и MTurk и экспорт в форматы, которые читают дальнейшие инструменты.
Требования
Potato должен быть установлен там, где агент запускает команды, потому что вспомогательные скрипты навыка импортируют Potato и вызывают команду potato:
pip install potato-annotationНужен также агент для программирования. Навык написан для Claude Code; другие агенты описаны в следующем разделе.
Установка навыка
В Claude Code:
/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato
Для Codex, Cursor и других агентов навык устанавливает в проект CLI skills:
npx skills add davidjurgens/potato-skill --agent codex cursorС --agent codex cursor она копирует навык в .agents/skills/potato-skill/. Codex и Cursor также могут читать файл AGENTS.md в корне репозитория potato-skill.
Описание исследования
Скажите, что нужно разметить, кто будет размечать и для чего нужны метки. Знать типы разметки Potato или формат его конфигурации не требуется. Запрос может быть таким коротким:
Хочу, чтобы трое разметчиков каждый разметили 200 твитов по тональности по 5-балльной шкале, со страницей согласия и двумя проверками внимания. Собери и запусти.
Навык определяет формулировки вопросов, шкалу, способ распределения элементов и способ проверки разметчиков. Затем агент собирает задачу, запускает её и проходит так, как это сделал бы разметчик, прежде чем передать её вам. Прежде чем кого-то приглашать, откройте её в браузере и сами разметьте несколько элементов.
Получаемая задача
Задача Potato: папка проекта с конфигурацией, данными и инструкциями задачи. К ней применимо всё, что описано в быстром старте. Вы запускаете её командой potato start config.yaml, правите вручную, добавляете разметчиков и экспортируете метки.
Поскольку результат — папка задачи Potato, ею могут пользоваться и другие. Коллега может провести то же исследование на новых данных, вы можете повторить его через год и опубликовать вместе со статьёй, в которой оно использовалось. Витрина — это собрание таких задач, взятых из опубликованных статей.
Готовые дизайны и существующая разметка
- Опубликованный дизайн. Навык может начать с одного из 440 дизайнов разметки, взятых из опубликованных статей, вместе с их наборами меток, формулировками вопросов и инструкциями. Их можно посмотреть на витрине.
- Разметка из другого инструмента. Он импортирует существующую разметку из Label Studio, CVAT или COCO, так что наполовину готовый проект можно продолжить в Potato.
- Идущее исследование. Он сообщает о прогрессе каждого разметчика и согласованности по каждому вопросу и говорит, какие исправления безопасны посреди исследования, а какие испортят уже собранные данные.
Тесты по реестрам Potato
CI навыка проверяет, что каждый тип разметки, ключ конфигурации и пример конфигурации, упомянутые в его инструкциях, существуют в Potato. Примеры YAML проходят через валидатор Potato, а полный пример поднимает настоящий сервер Potato. Три справочника навыка генерируются из собственных реестров Potato, поэтому типы и ключи, которые читает агент, совпадают с теми, что проверяет сервер.
Справочные материалы опубликованы на davidjurgens.github.io/potato-skill и доступны для чтения без установки. Anthropic рекомендует проверять любой навык перед установкой.
Сравнение двух способов
| Написать задачу самостоятельно | Описать её агенту для программирования | |
|---|---|---|
| Начинаете с | конфигурации YAML | описания обычным языком |
| Подходит для | знакомства с Potato, небольших задач | новых исследований, краудсорсинговых исследований с обучением и проверками, типов разметки, которыми вы ещё не пользовались |
| Получаете | задачу Potato | задачу Potato |
Способ можно сменить в любой момент. Агент может изменить задачу, которую написали вы, а вы можете отредактировать задачу, собранную агентом.