py-async

Installation
SKILL.md

Python 非同步與結構化並行

目標與邊界

用此 skill 建立可取消、有逾時、有背壓、會正確關閉資源的 asyncio 程式。非同步主要改善等待 I/O 時的併發,不會自動加速 CPU-bound 工作。

若主要交付物是網路協議,使用 py-network 為主;若只是同步程式的少量背景工作,不要為了「現代化」強行改成 async。

執行流程

  1. 辨識工作型態:區分 I/O-bound、CPU-bound、blocking library 與真正 async API。
  2. 定義 ownership:每個 task 由誰建立、等待、取消與收集錯誤。
  3. 使用結構化並行:parent scope 不結束,child task 就不能遺失。
  4. 設定 deadline:連線、單次操作與整體工作分別設 timeout。
  5. 限制並行與緩衝:Semaphore、Queue、connection pool 與 batch 都要有上限。
  6. 設計取消安全:CancelledError 必須向上傳播,資源在 finally/context manager 清理。
  7. 測試故障與關閉:timeout、partial failure、client disconnect、SIGTERM 與 task leak。
  8. 加入觀測:記錄 active tasks、queue depth、延遲、timeout、retry 與 cancellation。
Installs
2
GitHub Stars
1
First Seen
May 8, 2026