Python Async Runtime 是一个针对 Python 异步运行时代码编写的技能规则集,优先级标注为 P1(高)。其目标是在编辑 asyncio 相关工作流时,帮助写出正确、可观测、可维护的异步代码。
用途与适用场景 该技能适用于需要编写或修改 asyncio 代码的场合,尤其是涉及阻塞式数据库访问、子进程调用、旧式 HTTP 客户端,以及需要明确超时、取消和后台任务生命周期的异步工作流。
主要规则 技能给出的核心规则包括:把阻塞的数据库、子进程和旧式 HTTP 调用排除在事件循环代码之外;仅将 asyncio.to_thread 作为围绕阻塞库的显式边界使用;让超时和取消行为在调用路径中可见;有意识地跟踪长生命周期任务、清理与重试。
推荐做法
- 优先使用原生异步客户端。
- 在适配层接缝处一次性封装阻塞调用。
- 传播取消与超时上下文,而不是将其吞掉。
- 将轮询循环逻辑与工作项处理分离。
- 测试超时与错误路径,而不仅是正常路径。
反模式
- 不在 async def 中直接执行阻塞式 I/O。
- 不写没有停止条件或可观测性的隐藏无限循环。
- 不在 await 调用链外使用宽泛的 except Exception 捕获,以免抹掉任务状态。
- 不创建没有生命周期归属的孤儿后台任务。
其他说明 资料中还列出“框架地图”和“异步边界”两个参考条目,但未提供具体内容。该技能的安装方式、具体工具集成方式、平台限制与收费信息暂未提供。