Навык python-notebooks-async
✓ ПровереноПомогает агентам писать и проверять asyncio-код в Jupyter notebooks или ячеистых рабочих процессах, чтобы избежать конфликтов с event loop.
- Звёзды на GitHub
- 6
- Файлы
- 2
- Последний коммит
- 29 окт. 2026 г.
- Лицензия
- CC0-1.0
- Разрешённые инструменты
- —
Что делает навык python-notebooks-async?
python-notebooks-async — это Agent Skill. Помогает агентам писать и проверять asyncio-код в Jupyter notebooks или ячеистых рабочих процессах, чтобы избежать конфликтов с event loop.
Сводка сгенерирована из SKILL.md навыка.
О skill python-notebooks-async
Разработчики, работающие в Jupyter notebooks или с ячеистыми рабочими процессами, используют этот SKILL для управления асинхронным кодом на Python без возникновения конфликтов event loop. Он предоставляет рекомендации для агентов, которым поручено написание, проверка или перенос асинхронных скриптов в среды, где ядро блокнота уже управляет event loop. Следуя этим паттернам, агенты могут избежать распространенных ошибок, таких как RuntimeError при использовании asyncio.run() или задач, которые незаметно завершаются с ошибкой.
Агенту следует загрузить этот SKILL при обнаружении проблем с ошибками asyncio.run() в ячейках или при оркестрации параллельных задач с использованием gather или TaskGroup внутри ядер IPython. Этот SKILL сфокусирован на реализации top-level await, управлении переиспользуемой логикой в .py модулях и выборе между такими библиотеками, как aiohttp или httpx, вместо блокирующих вызовов. Он рассматривает nest_asyncio как резервный вариант, а не как основное решение, чтобы гарантировать надежность кода и не скрывать фундаментальные проблемы проектирования.
Что агент может делать с ним
- 1Исправление ошибок event loopУстранение ошибок RuntimeError, вызванных вызовом asyncio.run() внутри ячейки блокнота.
- 2Рефакторинг асинхронного кода в блокнотахПеренос встроенных асинхронных вспомогательных функций из ячеек блокнота во внешние Python модули для улучшения тестирования.
- 3Предотвращение проблем с блокирующим I/OПоиск и замена синхронных вызовов, которые блокируют event loop, на неблокирующие альтернативы.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык python-notebooks-async
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка python-notebooks-async в Claude Code
~/.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-asyncУстановка навыка python-notebooks-async в Claude Code (project)
.claude/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async .claude/skills/python-notebooks-asyncУстановка навыка python-notebooks-async в Codex
~/.agents/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.agents/skills/python-notebooks-asyncУстановка навыка python-notebooks-async в Gemini CLI
~/.gemini/skills/python-notebooks-async/SKILL.md
$ npx degit ahgraber/skills/skills/python-notebooks-async ~/.gemini/skills/python-notebooks-asyncУстановка навыка python-notebooks-async в Claude.ai
npx degit ahgraber/skills/skills/python-notebooks-async python-notebooks-async && zip -r python-notebooks-async.zip python-notebooks-async # claude.ai → Customize → Skills → + → Create skill → Upload a skill → python-notebooks-async.zip
Автоматические проверки
Запущено 16 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийahgraber/skills/skills/python-notebooks-async is public and reachablegithub.com/ahgraber/skills/tree/HEAD/skills/python-notebooks ↗Пройдено
- Open source лицензия (OSI)CC0-1.0spdx.org/licenses/CC0-1.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit 2026-10-29github.com/ahgraber/skills/commits ↗Пройдено
- В скриптах нет загрузки с запуском и кражи учётных данныхNo scripts in the skill folderПройдено
- В SKILL.md нет скрытых инструкцийNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Пройдено
- Заранее разрешённые инструменты ограниченыNo pre-approved tools; the agent asks before using onegithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Пройдено
- SKILL.md соответствует формату Agent SkillsValid name and description; says when to use it; 66 linesgithub.com/ahgraber/skills/blob/HEAD/skills/python-notebooks ↗Пройдено
SKILL.md
Открыть на GitHubPython Notebooks Async
Overview
Notebook kernels own the event loop; async code must cooperate with that ownership rather than fight it.
This skill covers orchestration patterns, top-level await, and compatibility constraints for .ipynb and #%% workflows.
Treat these recommendations as preferred defaults. When project constraints require deviation, call out tradeoffs and compensating controls.
When to Use
asyncio.run()raisesRuntimeErrorinside a notebook cell.- Event-loop conflicts when mixing async libraries in Jupyter.
- Porting async scripts into notebook workflows.
- Orchestrating concurrent tasks (
gather,TaskGroup) in IPython kernels. - Deciding where to place reusable async logic across notebook/module boundaries.
When NOT to Use
- Pure script or service code with no notebook involvement.
- Synchronous notebook workflows with no async needs.
- General asyncio API design outside notebook contexts — the
pythonskill covers concurrency audit defaults.
Invocation Notice
- Tell the user when this skill is running:
python-notebooks-async. Skip the notice when the user asked for the skill by name or slash command; spelling and spacing need not match. A phrase from this skill's own trigger list is not a name — naming the work is not naming the skill.
Quick Reference
- Treat notebook kernels as loop-owned environments; never create a competing loop.
- Use top-level
awaitinstead ofasyncio.run()in notebook cells. - Orchestrate concurrent work with
asyncio.gather()orasyncio.TaskGroup. - Keep reusable async logic in regular
.pymodules, imported into notebooks. - Use
nest_asyncioonly as a constrained compatibility fallback, not a default. - Avoid fire-and-forget tasks — always
awaitor collect results explicitly.
Common Mistakes
- Calling
asyncio.run()in a notebook cell. The kernel already runs a loop;asyncio.run()tries to start a second one and raisesRuntimeError. Useawaitdirectly instead. - Applying
nest_asyncioglobally by default. It patches the loop to allow reentrant calls but masks design problems and can hide subtle concurrency bugs. Reserve it for legacy compatibility. - Defining async helpers inline in cells instead of modules.
Inline definitions are lost on kernel restart and cannot be tested outside the notebook.
Extract to
.pyfiles. - Ignoring returned tasks or coroutines.
Calling an async function without
awaitsilently produces a never-executed coroutine object, with no error until results are missing downstream. - Mixing blocking I/O with async in the same cell.
Synchronous calls like
requests.get()block the event loop, starving concurrent tasks. Useaiohttp,httpx, orasyncio.to_thread().
References
references/notebooks-async.md— event-loop ownership, background-work and fire-and-forget patterns, script/notebook compatibility, blocking-library interop,nest_asynciopolicy
Файлы в этом навыке
2Вопросы о навыке python-notebooks-async
Как установить навык python-notebooks-async в Claude Code?
Выполните npx degit ahgraber/skills/skills/python-notebooks-async ~/.claude/skills/python-notebooks-async. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык python-notebooks-async?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
Почему asyncio.run() вызывает RuntimeError в моем блокноте?
Ядро блокнота уже владеет и управляет event loop; вызов asyncio.run() пытается запустить второй цикл, что вызывает конфликт. Используйте top-level await вместо этого.
Стоит ли использовать nest_asyncio в моих рабочих процессах в блокноте?
Используйте nest_asyncio только как ограниченное средство обеспечения совместимости для устаревшего кода, а не как стандартное решение, так как это может скрывать ошибки проектирования и проблемы с конкурентностью.
Как мне не заблокировать event loop в ячейке блокнота?
Избегайте использования синхронного блокирующего ввода-вывода, такого как requests.get(); вместо этого используйте асинхронные библиотеки, такие как aiohttp или httpx, либо оборачивайте синхронные вызовы в asyncio.to_thread().