В таблице четыре строки: две продажи, копия одной продажи и запись без суммы. Если попросить AI сразу написать выводы, он может включить дубль в выручку или молча заменить пропуск нулём. Тогда аккуратный отчёт будет опираться на неверную базу.
Полезный скилл анализа начинается с проверки данных. В этой статье разберём такую процедуру; готовый установленный скилл или программный пакет здесь не предлагается.
Что превращает инструкцию в процедуру
В спецификации Agent Skills навык описывается через SKILL.md и метаданные, включая название и описание. Но оформление ещё не определяет качество анализа. Для полезной процедуры нужны вход, последовательность действий и критерии результата.
Входом является конкретный файл, лист или диапазон, а также вопрос пользователя. Выходом — проверяемый расчёт, отчёт о качестве данных и вывод с ограничениями. Если вопрос не задан, стоит начать с описания структуры, а не самостоятельно придумывать бизнес-задачу.
Скилл должен отличать идентификатор от числа, пустую ячейку от нулевого значения, повтор записи от двух похожих операций. Решение принимается по смыслу данных; автоматическое удаление одинаковых строк может уничтожить реальные события.
Учебная таблица
Набор ниже синтетический. operation_id выбран идентификатором операции; одинаковая повторная запись одной операции должна учитываться один раз. Суммы приведены в условных денежных единицах.
| operation_id | Регион | Сумма |
|---|---|---|
| 001 | Север | 1 200 |
| 002 | Юг | 800 |
| 002 | Юг | 800 |
| 003 | Север | Не указана |
Сумма всех заполненных строк составляет 2 800. При заданном правиле исключения точного дубля известная сумма уникальных операций равна 2 000. Полная сумма по трём уникальным операциям неизвестна: для операции 003 отсутствует значение.
Здесь нельзя написать «общая выручка равна 2 000». Корректнее: «известная сумма уникальных операций — 2 000; одна операция не имеет суммы». Это разница между расчётом и бизнес-утверждением.
Порядок работы с реальным файлом
- Определить область анализа. Назвать файл, лист, диапазон и период. Не объединять все листы только потому, что они находятся в одном workbook.
- Описать поля. Разделить идентификаторы, даты, категории, числа и текст. Зафиксировать единицы и валюты.
- Проверить качество. Посчитать пропуски, обнаружить повторы и противоречащие записи одного идентификатора.
- Согласовать трактовку. Определить, что делать с неизвестными значениями, отменами и дублированием. Существенное правило не должно появляться незаметно внутри расчёта.
- Выполнить расчёты. Сохранить фильтры, формулы и число участвующих записей.
- Сверить итог. Проверить агрегаты по группам и общий результат на одной и той же базе.
- Написать вывод. Отделить вычисленные значения от предположений о причинах.
Для учебной таблицы после исключения дубля известные суммы по регионам: Север — 1 200, Юг — 800. Они дают 2 000. При этом сравнивать полную выручку регионов нельзя: неизвестная сумма относится к Северу.
CSV и Excel могут читаться по-разному
У CSV нужно установить разделитель, кодировку, десятичный знак и правила чтения пропусков. Документация pandas.read_csv описывает параметры для этих случаев. Она также позволяет задавать типы, что важно для идентификаторов: 001 не следует автоматически превращать в 1, если ведущие нули значимы.
У Excel необходимо выбрать лист и область данных. В pandas.read_excel описаны параметры листов, типов и пропусков. Сам факт чтения файла не подтверждает, что инструмент пересчитал формулы, правильно учёл внешние связи или выбрал нужный диапазон.
Эти ссылки объясняют особенности одного средства чтения. Процедура не требует использовать именно pandas: важны правильная интерпретация и возможность проверить расчёт в выбранной среде.
Постановка задачи помощнику
> Проанализируй указанный лист таблицы по вопросу [вопрос]. Сначала опиши поля, единицы, пропуски и повторы. Не изменяй исходный файл. Идентификаторы сохраняй как идентификаторы. Перед расчётом явно назови правила обработки отсутствующих значений и дублей. Верни расчёты с фильтрами и числом записей, затем выводы и ограничения. Если данных недостаточно, не подставляй предположения.
Как принять отчёт
Для учебного входа проверьте четыре условия: сохранены ведущие нули, обнаружен точный дубль, известная сумма после его исключения равна 2 000, полный итог не назван известным. Затем усложните вход: один идентификатор с двумя разными суммами. Такой конфликт требует разбора; удаление одной строки без основания недопустимо.
Не загружайте рабочую таблицу в модель только потому, что расчёт кажется простым. Проверьте способ обработки данных и используйте обезличенный фрагмент, если он достаточен для задания.
Организация навыка связана с проектными инструкциями; для оценки процедуры полезна статья о promptfoo, для выбора локального режима — Ollama.