Локализованное руководство по чтению
xlsxНазначение, использование и источник
Используйте этот навык всякий раз, когда в качестве основного входного или выходного файла используется электронная таблица. Это означает любую задачу, в которой пользователь хочет: открыть, прочитать, отредактировать или исправить существующий файл .xlsx, .xlsm, .xltx, .csv или .tsv (например, добавить столбцы, вычислить формулы, отформатировать, построить диаграммы, очистить некорректные данные); создать новую электронную таблицу с нуля или из других источников данных; или преобразовать данные между табличными форматами. Особенно полезно, когда пользователь ссылается на файл электронной таблицы по имени или пути — даже вскользь (например, «файл xlsx в моих загрузках») — и хочет что-то с ним сделать или получить из него результат. Также полезно для очистки или реструктуризации некорректных табличных данных (неправильно сформированные строки, смещенные заголовки, ненужные данные) в правильные электронные таблицы. Результатом работы должен быть файл электронной таблицы. НЕ используйте этот навык, если основным результатом работы является документ Word, HTML-отчет, автономный скрипт Python, конвейер обработки данных в базе данных или интеграция с API Google Sheets, даже если в нем используются табличные данные.
Источник получен:
- Репозиторий-источник
- anthropics/skills
- SKILL.md
skills/xlsx/SKILL.md- Звёзды репозитория
- 185,373
- Последнее обновление репозитория
- 2026-10-29
- Категории Skills
- Данные
- Время последнего сбора
Лицензия: Файл лицензии требует проверки
Приведенные фрагменты описания рабочих процессов являются вспомогательными средствами для чтения, а не исполняемыми инструкциями от Codez. Для создания этой страницы не использовались сторонние инструменты.
Приведённые ниже фрагменты, описывающие цели и рабочие процессы, представляют собой исходный материал, систематизированный и переведённый для удобства чтения. Они отличаются от отдельно обозначенного редакционного анализа Codez.
Что делает этот навык
Используйте этот навык всякий раз, когда в качестве основного входного или выходного файла используется электронная таблица. Это означает любую задачу, в которой пользователь хочет: открыть, прочитать, отредактировать или исправить существующий файл .xlsx, .xlsm, .xltx, .csv или .tsv (например, добавить столбцы, вычислить формулы, отформатировать, построить диаграммы, очистить некорректные данные); создать новую электронную таблицу с нуля или из других источников данных; или преобразовать данные между табличными форматами. Особенно полезно, когда пользователь ссылается на файл электронной таблицы по имени или пути — даже вскользь (например, «файл xlsx в моих загрузках») — и хочет что-то с ним сделать или получить из него результат. Также полезно для очистки или реструктуризации некорректных табличных данных (неправильно сформированные строки, смещенные заголовки, ненужные данные) в правильные электронные таблицы. Результатом работы должен быть файл электронной таблицы. НЕ используйте этот навык, если основным результатом работы является документ Word, HTML-отчет, автономный скрипт Python, конвейер обработки данных в базе данных или интеграция с API Google Sheets, даже если в нем используются табличные данные.
Как работает рабочий процесс на вышестоящем уровне
Создание, редактирование и анализ файлов XLSX.
>openpyxl,pandas, иmarkitdownустановлены по умолчанию — не запускайтеpip installСначала напишите скрипт и импортируйте напрямую. Только если импорт не удастся (или...)markitdownотсутствует команда):pip installОтсутствующий пакет. > Пути к скриптам ниже указаны относительно каталога этого навыка.
Выбор формул, которые выдерживают проверку.
LibreOffice реализует меньше функций, чем Excel, и та, которую он не может обработать, становится буквальной.#NAME?встроено в предоставляемый вами файл. Предпочтительно Excel.2007функции эпохи —SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT— которым не нужен префикс.
подводные камни OpenPyXL
Для чтения модели требуется две загрузки.data_only=TrueВ результате получаются кэшированные значения без формул; по умолчанию получаются строковые формулы без значений. За один проход невозможно получить и то, и другое.data_only=TrueСохранение приведет к необратимым последствиям. В этой рабочей книге не осталось формул, поэтому при сохранении каждая из них будет заменена на буквальное значение — навсегда.
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30Требования и настройка
Требования к каждому выходному сигналу
Профессиональный шрифт (Arial, Times New Roman) используется везде, если пользователь не указал иное. Отсутствие ошибок в формулах. Отправка осуществляется только в нерабочем состоянии.recalc.pyотчетыerrors_foundЕсли вы считаете, что ошибка произошла до вас, докажите это: загрузите *оригинал* с помощьюdata_only=TrueПосмотрите на эту ячейку. Ошибка, которую вы допустили, выглядит точно так же, как и та, которую вы унаследовали.
Зависимости
openpyxl,pandas,markitdown(pip, предустановлен — устанавливайте только в случае сбоя импорта или отсутствия команды) · LibreOffice (sofficeАвтоматическая настройка для изолированных сред с помощьюscripts/office/soffice.py)
Ограничения и проверки качества
Пересчитать (обязательно, если файл содержит формулы)
openpyxl записывает формулы как строки без кэшированных значений. Пока вы не выполните перерасчет, каждая ячейка с формулой будет считываться как строка.Noneдля любого устройства, считывающего кэшированные значения —pandas,load_workbook(data_only=True)и большинство программ предварительного просмотра. LibreOffice вычисляет каждую формулу, файл перезаписывается на месте, и вы получаете JSON:status(success|errors_found),total_formulas,total_errorsи одинerror_summaryнаименование до100ячеек по типу ошибки (locations_truncatedговорит, сколько было утаено — довериеtotal_errors(не длина списка). Исправьте имена и запустите снова. JSON сerrorключ вместоstatusЭто означает, что ничего не пересчитывалось, и только в этом случае существует ненулевое значение.errors_foundвыходы0Поэтому никогда не рассматривайте чистый выход как чистую рабочую тетрадь.
Начните с безопасного пробного периода.
- Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
- Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
- Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
- Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.
Подробнее читайте в источнике.
Смежные навыки
Перевод и сфера применения
В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.
Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.
- Закрепленный источник
- Прочитайте оригинал ↗
- Источник получен
- Исходный коммит
ca45fc496a3436251f191354091d557da31c15b5- Исходный SHA-256
6712b39718fe815054abca9c3ee72f989613e6f771c8a5c58f30a65a6c905622