技能 async-python-patterns

📦

async-python-patterns

Name: async-python-patterns
Author: wshobson

内容修订 r1 中风险 ⚙️ 外部命令🌐 网络访问

构建可靠的异步 Python 系统

当任务、超时、取消和阻塞调用相互作用时，异步 Python 代码很容易写错。此技能为 Claude、Codex 和 Claude Code 提供更安全的 asyncio 设计与审查实用模式。

支持: Claude Codex Code(CC)

📊 69 合格

使用我的智能体安装

将此请求复制给你的智能体，其中包含权威 Skill 页面和清单。

智能体请求

Review the Skillstore skill "async-python-patterns" from https://skillstore.io/skills/wshobson-async-python-patterns.md and its manifest at https://skillstore.io/api/skills/wshobson-async-python-patterns/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

你的智能体仍应展示其计划，并按安全策略请求必要确认。

Agent 可读资源

当 AI Agent、爬虫或脚本需要干净上下文，而不是读取完整页面时，请使用这些链接。

Markdown 详情 GET /skills/wshobson-async-python-patterns.md 已签名 manifest GET /api/skills/wshobson-async-python-patterns/manifest 已签名 lockfile GET /api/skills/wshobson-async-python-patterns/lockfile

测试它

正在使用“async-python-patterns”。我需要获取许多 API，但不能让上游服务不堪重负。

预期结果:

一个有界并发方案，使用信号量、单请求超时、连接池，并通过显式错误处理收集结果。

正在使用“async-python-patterns”。我的异步 worker 有时会在关闭期间挂起。

预期结果:

一份审查清单，涵盖取消传播、队列排空、超时保护、任务清理，以及关闭路径测试。

正在使用“async-python-patterns”。我想教我的团队 asyncio 模式。

预期结果:

一条结构化学习路径，从 coroutine 到 task、队列、同步、aiohttp 使用和 pytest-asyncio 测试。

安全审计

中风险

v7 • 2026/7/7 打开版本化报告

Most static findings are false positives caused by Markdown backticks, placeholder URLs, or benign sample identifiers. One semantic issue remains: the database example builds SQL with f-string interpolation, which may teach unsafe query construction if copied.

已扫描文件

695

分析行数

复核项

已忽略误报

已确认安全问题 (1)

中

SKILL.md:459-463

Unsafe SQL Construction in Example

The database example builds SQL strings with f-strings using user_id. Readers may copy this pattern instead of parameterized queries.

The code constructs three SQL queries through f-string interpolation. It is instructional sample code, so the risk is guidance quality rather than active execution.

风险因素

⚙️ 外部命令 (48)

SKILL.md:33 SKILL.md:36-40 SKILL.md:40-49 SKILL.md:49-52 SKILL.md:52-56 SKILL.md:56-66 SKILL.md:66-72 SKILL.md:72-85 SKILL.md:85-89 SKILL.md:89-110 SKILL.md:110-114 SKILL.md:114-140 SKILL.md:140-144 SKILL.md:144-176 SKILL.md:176-180 SKILL.md:180-197 SKILL.md:197-203 SKILL.md:203-233 SKILL.md:233-237 SKILL.md:237-267 SKILL.md:267-271 SKILL.md:271-323 SKILL.md:323-327 SKILL.md:327-351 SKILL.md:351-355 SKILL.md:355-394 SKILL.md:394-400 SKILL.md:400-437 SKILL.md:437-441 SKILL.md:441-479 SKILL.md:479-483 SKILL.md:483-539 SKILL.md:539-545 SKILL.md:545-557 SKILL.md:557-561 SKILL.md:561-574 SKILL.md:574-578 SKILL.md:578-601 SKILL.md:601-607 SKILL.md:607-613 SKILL.md:613-617 SKILL.md:617-626 SKILL.md:626-630 SKILL.md:630-641 SKILL.md:641-645 SKILL.md:645-653 SKILL.md:653-657 SKILL.md:657-673

🌐 网络访问 (9)

SKILL.md:81 SKILL.md:263 SKILL.md:346 SKILL.md:427 SKILL.md:428 SKILL.md:429 SKILL.md:554 SKILL.md:665 SKILL.md:677

审计者: codex 查看审计历史 →

分享与引用此报告

分享版本化评估报告、中性徽章、嵌入卡片和引用。Skillstore 只报告证据，不判断该 Skill 是否安全。

打开版本化报告

复制报告链接

https://skillstore.io/skills/wshobson-async-python-patterns/audits/7?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown 徽章

[![Skillstore security assessment](https://skillstore.io/badges/skills/wshobson-async-python-patterns/security.svg)](https://skillstore.io/skills/wshobson-async-python-patterns?utm_source=security_passport_badge)

HTML 徽章

<a href="https://skillstore.io/skills/wshobson-async-python-patterns?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/wshobson-async-python-patterns/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

嵌入卡片

<iframe src="https://skillstore.io/embed/skills/wshobson-async-python-patterns.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

学术引用 (APA · BibTeX · CFF)

APA 引用

wshobson. (2026). async-python-patterns security audit report (audit version 7) [Author version unspecified]. Skillstore. https://skillstore.io/skills/wshobson-async-python-patterns/audits/7

BibTeX 引用

@techreport{wshobson-wshobson-async-python-patterns-2026,
  author = {wshobson},
  title = {async-python-patterns security audit report (audit version 7)},
  institution = {Skillstore},
  year = {2026},
  number = {7},
  url = {https://skillstore.io/skills/wshobson-async-python-patterns/audits/7},
  note = {Author version unspecified}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "async-python-patterns security audit report (audit version 7)"
version: "unspecified"
type: report
authors:
  - name: "wshobson"
date-released: "2026-07-07"
url: "https://skillstore.io/skills/wshobson-async-python-patterns/audits/7"
identifiers:
  - type: other
    value: "skillstore:wshobson-async-python-patterns:audit:7"
    description: "Skillstore immutable audit report identifier"

比较变体

3 个可安装变体

每位作者的技能都保持为独立的可安装项。推荐变体按 Skillstore 证据排序。

为什么此变体排名第一

Skillstore 评分最高

作者 / 来源 Skillstore 评分证据置信度 Skillstore 使用量已更新

sickn33 推荐

sickn33-async-python-patterns

Skillstore 评分 70

证据置信度高

Skillstore 使用量 9

已更新

2026-09-09

ActiveInferenceInstitute

activeinferenceinstitute-async-python-patterns

Skillstore 评分 69

证据置信度高

Skillstore 使用量 13

已更新

2026-09-09

wshobson 当前

wshobson-async-python-patterns

Skillstore 评分 69

证据置信度高

Skillstore 使用量 12

已更新

2026-09-09

Skillstore 评分

评分依据证据置信度: 高

架构

可维护性

内容

社区

规范符合性

你能构建什么

规划异步 API 服务

在实现异步 Web 服务之前，设计任务边界、超时、连接池和取消处理。

审查并发 Python 代码

检查 asyncio 实现中是否存在阻塞调用、缺失 await、无界 gather 使用和薄弱的错误处理。

学习实用异步模式

通过聚焦示例理解队列、信号量、锁、异步迭代器和测试结构。

试试这些提示

解释异步基础

Use the async-python-patterns skill to explain coroutines, tasks, and await using a small Python service example.

设计并发请求

Use the async-python-patterns skill to design a bounded concurrent request workflow with timeouts, retries, and clear cancellation behavior.

审查现有异步代码

Use the async-python-patterns skill to review my asyncio code for blocking calls, missing awaits, task leaks, and unsafe gather usage.

设计异步流水线架构

Use the async-python-patterns skill to propose an async producer-consumer pipeline with backpressure, rate limits, graceful shutdown, and test strategy.

最佳实践

围绕外部 I/O 设置显式超时，并干净地传播取消。
使用信号量、队列或连接限制来约束并发，而不是启动无限数量的任务。
避免在事件循环中执行阻塞工作，或将其移至带有明确限制的 executor。

避免

在 async 函数内调用 time.sleep 等阻塞函数。
创建任务后，在关闭期间既不 await、不跟踪，也不取消它们。
未进行验证和参数绑定，就将简化的 SQL 或 HTTP 示例复制到生产环境。

常见问题

这个技能会执行 Python 代码吗？

不会。它是一个 Markdown 指导技能，包含供 AI 助手参考的示例。

它能帮助 FastAPI 或 aiohttp 项目吗？

可以。它包含异步 API 和 aiohttp 模式，可用于指导服务设计和代码审查。

它是否涵盖取消和关闭？

涵盖。它包含取消处理概念，以及长时间运行的异步任务中的常见陷阱。

它能优化 CPU 密集型 Python 代码吗？

只涵盖一部分。它解释了 executor 的使用，但 asyncio 主要用于 I/O 密集型工作负载。

这些示例可以直接用于生产环境吗？

不能。它们是教学示例，应结合验证、参数绑定、日志记录和可观测性进行调整。

哪些 AI 工具可以使用此技能？

报告列出了对 Claude、Codex 和 Claude Code 的支持。

开发者详情

作者

wshobson

许可证

MIT

Skillstore 修订

版本提示

作者未声明版本。

仓库

https://github.com/wshobson/agents/tree/main/plugins/python-development/skills/async-python-patterns

引用

36e07d5e13068e5be64447e8f20b427cf2cbd21a

维护新鲜度

2026/7/18

使用量

8 次下载 · 321 次浏览

文件结构

📄 SKILL.md