异步Python模式

1. 📌 Skill基础信息

Skill名称：async-python-patterns

简称：异步Python模式

来源：社区第三方（lactuphong）

运行宿主：只能在使用 antigravity-awesome-skills 框架的Agent工具中运行

核心定位：提供使用asyncio和异步编程模式的全面指导，帮助开发者构建高性能、非阻塞的异步Python应用系统。

2. 🧩 内部核心组成

该Skill主要包含以下核心组件：

资源文件集合：

• resources/implementation-playbook.md：详细实现模式和示例的指导手册

核心能力特点：

• 异步编程模式指导（tasks、gather、queues、pools等）
• 并发控制与取消规则
• 超时管理和背压机制
• 结构化错误处理方案
• 异步代码测试和调试指南

3. 🛠 安装与启用方式

安装命令：

skills install --user lactuphong/antigravity-awesome-skills

前置要求：

• 已部署 antigravity-awesome-skills 框架环境
• Python 3.7+ 运行环境
• asyncio 库支持

启用方式：安装后Skill将自动集成到宿主Agent工具中，通过相关指令调用。

4. 📋 标准工作流

1. 需求分析：用户提出异步编程需求，明确工作负载特性（I/O密集型 vs CPU密集型）
2. 模式选择：Skill提供合适的并发模式建议（任务、队列、线程池等）
3. 实现指导：根据选择的模式提供具体的实现方案和代码结构
4. 优化建议：推荐超时设置、背压控制和错误处理策略
5. 详细参考：如需具体示例，引导用户查阅 resources/implementation-playbook.md

5. ⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅支持Python 3.7+环境
• 需要宿主Agent支持antigravity-awesome-skills框架

适用性限制：

• 不适用于CPU密集型且I/O操作极少的工作负载
• 不适用于简单的同步脚本场景
• 运行环境必须支持asyncio/事件循环

生产环境建议：

• 适用于生产环境，但需要充分测试异步代码路径
• 建议在类似生产环境的中等规模项目中验证后再上大规模生产

6. ✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

• 构建异步Web API（FastAPI、aiohttp、Sanic）
• 实现并发I/O操作（数据库、文件、网络）
• 创建具有并发请求的网页爬虫
• 开发实时应用程序（WebSocket服务器、聊天系统）
• 同时处理多个独立任务
• 构建具有异步通信的微服务
• 优化I/O密集型工作负载
• 实现异步后台任务和队列

❌ 不适合场景

• 工作负载主要是CPU密集型且I/O操作极少
• 简单的同步脚本即可满足需求
• 运行时环境不支持asyncio/事件循环使用
• 项目规模过小，引入异步复杂度得不偿失

skills install --user lactuphong/antigravity-awesome-skills