py-async
Installation
SKILL.md
Python 非同步與結構化並行
目標與邊界
用此 skill 建立可取消、有逾時、有背壓、會正確關閉資源的 asyncio 程式。非同步主要改善等待 I/O 時的併發,不會自動加速 CPU-bound 工作。
若主要交付物是網路協議,使用 py-network 為主;若只是同步程式的少量背景工作,不要為了「現代化」強行改成 async。
執行流程
- 辨識工作型態:區分 I/O-bound、CPU-bound、blocking library 與真正 async API。
- 定義 ownership:每個 task 由誰建立、等待、取消與收集錯誤。
- 使用結構化並行:parent scope 不結束,child task 就不能遺失。
- 設定 deadline:連線、單次操作與整體工作分別設 timeout。
- 限制並行與緩衝:Semaphore、Queue、connection pool 與 batch 都要有上限。
- 設計取消安全:
CancelledError必須向上傳播,資源在finally/context manager 清理。 - 測試故障與關閉:timeout、partial failure、client disconnect、SIGTERM 與 task leak。
- 加入觀測:記錄 active tasks、queue depth、延遲、timeout、retry 與 cancellation。