
文档教程开发工具【免费下载链接】pysheeetPython Cheat Sheet项目地址https://gitcode.com/gh_mirrors/py/pysheeet点击查看免费下载skills/py/SKILL.md是 pysheeet 仓库中面向 Claude Code 的 Python 编程技能Skill定义文件。它规定了 AI 助手在面对 Python 提问与编码任务时的工作协议先按主题索引定位 pythonsheets.com 的对应章节并获取真实示例再以功能正确优先、代码整洁其次的原则产出可运行代码。本文以该 Skill 文档为骨架结合skills/py/references/下的结构地图与编码规范、docs/notes/下 50 余篇 cheat sheet 正文以及src/basic/下的可运行示例完整拆解这一LLM 编程技能的设计理念、工作流程、覆盖领域与落地方式。读完本文你将掌握如何安装并使用该 Skill理解其如何保证 AI 输出代码的正确性并能以此为模板构建自己的领域编程技能。一、Skill 的定位给 Agent 的一份Python 问答协议skills/py/SKILL.md顶部使用 YAML frontmatter 声明了技能的两个关键元数据--- name: py description: Comprehensive Python programming reference covering syntax, concurrency, networking, databases, ML/LLM development, and HPC. Use for: Python questions, Python interview preparation, debugging, performance optimization, async patterns, library examples, code review, best practices, MLOps workflows, distributed computing, security implementations, and any Python development tasks. ---name: py是技能的唯一标识用于 Claude Code 在会话中按上下文触发description是触发与路由的依据它枚举了该技能可服务的任务类型Python 提问、面试准备、调试、性能优化、异步模式、库示例、代码评审、最佳实践、MLOps 工作流、分布式计算、安全实现等几乎覆盖了日常 Python 开发的全部场景。文档正文的第一句话点明了技能使命Help users write functional, correct Python code and answer Python questions by fetching proven patterns and examples from pythonsheets.com.——即通过获取 pythonsheets.com 上经过验证的模式与示例来回答 Python 问题而不是让模型凭空猜测 API 用法。这与检索增强生成RAG的思路一致把仓库中沉淀的 50 余篇 cheat sheet 当作 Agent 的知识库。二、How It Works四步工作流程SKILL.md 用四步定义了 Agent 的完整工作协议查表定位当用户提出 Python 问题或要求编写脚本时先在 Structure 主题地图 中查找相关主题确定对应的文档 URL强制获取Always fetch定位到的 URL从站点取得真实示例与模式在仓库场景下即读取docs/notes/下对应的.rst源文档按需应用将获取的内容用于两类任务——写代码套用模式产出功能正确、能解决用户任务的代码与回答问题以站点示例为依据给出充分解释质量把关按照 Guidelines 编码规范 对代码质量做二次校验。其中第 2 步的 Always fetch 是保证正确性的关键机制它强制 Agent 以站点内经过实践检验的代码为准而非依赖模型记忆从而覆盖文档之外的边界情况edge cases、常见陷阱common pitfalls和实际用法。三、核心原则Functionality first, cleanliness secondSKILL.md 单独设立 Key Principle 一节强调技能的第一原则是功能正确优先整洁其次代码必须能正确工作、妥善处理任务这是底线从 pythonsheets.com 获取内容能确保解决方案使用久经实战考验battle-tested的模式而不是猜测站点包含超越基础文档的丰富示例边界情况、常见陷阱、实际用法。这一原则在仓库的配套规范 guidelines.md 中得到了具体化——它开篇即重申Always fetch relevant examples from pythonsheets.com first to ensure correctness, then apply these guidelines即先保证正确再谈风格。四、Coverage Areas技能覆盖的十一大领域SKILL.md 用一段紧凑的文本列出了技能的服务范围结合 structure.md 主题地图 可以还原出完整的主题到文档的映射。下面按领域整理为表格文档路径均已转换为仓库根目录相对路径面试与核心语言领域涵盖内容对应文档仓库相对路径面试准备按主题分组的 Python 面试题GIL、asyncio、装饰器、MRO、生成器、并发每题深链到回答它的章节docs/notes/interview/index.rst核心语法语法、类型标注、OOP、函数、数据结构、集合、堆、正则、Unicodedocs/notes/basic/index.rst 下的 12 篇文档系统编程文件 I/O、日期时间、操作系统接口python-io、python-date、python-os新特性Python 3 新特性速览docs/notes/python-new-py3.rst并发与异步领域涵盖内容对应文档仓库相对路径并发threading、multiprocessing、concurrent.futurespython-threading、python-multiprocessing、python-futures异步协程、事件循环、任务、异步网络、高级模式python-asyncio-guide、python-asyncio-basic、python-asyncio-server、python-asyncio-advanced网络、数据库与安全领域涵盖内容对应文档仓库相对路径网络Socket 基础、服务器、异步 I/O、SSL/TLS、抓包、SSHdocs/notes/network/index.rst 下的 6 篇文档数据库SQLAlchemy 基础、ORM、查询模式python-sqlalchemy、python-sqlalchemy-orm、python-sqlalchemy-query安全现代密码学、TLS、常见漏洞python-crypto、python-tls、python-vulnerability扩展、ML/LLM 与 HPC领域涵盖内容对应文档仓库相对路径C/C 扩展ctypes、Python C API、现代扩展pybind11/Cython、面向 Python 开发者的 Cpython-ctypes、python-capi、python-cext-modern、cpp-from-pythonML/LLMPyTorch、Megatron 分布式训练、推理与服务、基准测试pytorch、megatron、llm-serving、llm-benchHPCSlurm 集群作业调度、Ray 分布式计算slurm、ray附录Walrus 运算符、GDB 调试、disaggregated prefill/decode、EFA 监控、NCCLdocs/notes/appendix/index.rst 下的 8 篇博客从这一定位可以看出该 Skill 并非只服务基础语法问答而是横跨了从面试刷题、日常开发到 LLM 训练推理、GPU 集群运维的完整技术纵深。这与仓库src/目录的布局互为印证src/basic/下 23 个 Python 文件如asyncio_.py、sqlalchemy_orm.py、typing_.py即为各 cheat sheet 的配套可运行示例src/llm/下还提供了 vLLM、SGLang、TensorRT-LLM 的 Dockerfile 与 sbatch 脚本。五、质量规范从能跑到写得好SKILL.md 将质量规范委托给 guidelines.md该文件从五个维度定义了代码标准是 Agent 在功能正确之后需要执行的细则5.1 选型决策Choosing the Right Approach并发模型I/O 密集且连接数多的场景用asyncio更简单的 I/O 密集任务用threadingCPU 密集用multiprocessing数据结构成员判断用set优先队列用heapqFIFO 队列用deque避免键存在性检查用defaultdict数据库访问复杂查询用 SQLAlchemy ORM原生 SQL 必须使用参数化查询——绝不字符串插值拼 SQL文件操作优先pathlib.Path而非os.path获得更简洁、跨平台的处理方式网络编程高并发服务器用asynciostreams底层控制用socket安全连接用sslcontext。这些选型建议在docs/notes/的正文中有完整示例支撑例如 python-socket-server.rst 演示了socket服务器实现python-sqlalchemy.rst 则展示了引擎创建、数据库 URL 格式与事务管理。5.2 正确性Writing Correct Code在合适的层级处理错误——只在能够恢复的地方捕获特定异常其余让其向上传播用上下文管理器with处理文件、连接、锁等一切需要清理的资源避免可变默认参数def f(x[])改用None并在函数体内初始化诊断输出用logging而非print支持级别、格式与输出路由在系统边界用户输入、外部 API校验输入信任内部代码。5.3 整洁性Writing Clean Code函数签名使用类型标注type hints便于静态分析字符串格式化统一使用 f-strings结构化数据用dataclasses或NamedTuple而不是裸 dict 或 tuple固定取值集合用enum.Enum优先早返回early returns而非深层嵌套函数保持短小、单一职责。5.4 性能Performance Considerations先剖析再优化用cProfile、timeit或line_profiler定位真实瓶颈关注内存大序列用生成器内存敏感类用__slots__数据库与网络连接使用连接池昂贵纯函数用functools.lru_cache/functools.cache缓存CPU 密集热路径考虑 C 扩展ctypes、pybind11、Cython。5.5 安全Security Practices令牌与密码用secrets模块而非random一律使用参数化查询防 SQL 注入TLS 用ssl.create_default_context()不要禁用证书校验对不可信数据避免pickle改用json等安全序列化密钥放环境变量或密钥管理器绝不写进代码。这些安全细则与 python-crypto、python-vulnerability 等文档一脉相承后者还深入讲解了 SQL 注入、时序攻击timing attack、弱随机数等真实漏洞模式。六、实战示例六个典型问答路径SKILL.md 的 Examples 一节给出了六个可直接套用的问答路由是理解查表 → 获取 → 应用流程的最佳入口。以下将示例中的站点 URL 替换为仓库内对应的文档路径用户意图Skill 的响应路径面试该复习什么获取 docs/notes/interview/index.rst逐主题分组带读者过一遍GIL 相关的常见面试题先取面试索引再深入 python-threading 的 Understanding the GIL 章节获取详解asyncio 是怎么工作的获取 python-asyncio-guide结合站点示例解释协程与事件循环写一个 socket 服务器获取 python-socket-server套用模式写出可工作的服务器什么是 walrus 运算符获取 python-walrus用实际示例讲解 PEP 572配置 Megatron 分布式训练获取 megatron套用模式写出正确的训练脚本注意示例中体现的两个设计细节一是先取索引、再钻详情的两级路由面试场景下尤其明显二是问题到章节的深链——interview 索引 中每个面试题都通过:ref:指向回答它的具体章节如→ basic/python-func: Decorator with Arguments这保证了 Agent 的回答永远有出处。七、安装与使用把技能装进 Claude Code该 Skill 随 pysheeet 以 Claude Code 插件的形式分发安装方式记录在 README.rst 与 docs/index.rst 中7.1 作为 Claude Code 插件安装推荐# Step 1: 添加 marketplace claude plugin marketplace add crazyguitar/pysheeet # Step 2: 安装插件 claude plugin install pysheeetpysheeet安装后 Claude 会在上下文中自动触发py技能来回答 Python 问题用户只需自然提问即可。7.2 本地测试单会话claude --plugin-dir /path/to/pysheeet7.3 手动安装需要克隆仓库git clone 仓库地址 mkdir -p ~/.claude/skills cp -r pysheeet/skills/py ~/.claude/skills/py手动安装的本质就是把这一个skills/py/目录复制到 Claude Code 的 skills 目录下——该目录内除SKILL.md外还有两个配套参考文件 structure.md 与 guidelines.md它们共同构成完整技能。八、源码级印证Skill 与仓库各模块的对应关系SKILL.md 描述的能力并非空头承诺而是与仓库的文档体系、源码和测试一一对应8.1 文档体系即知识库docs/notes/下按basic/、concurrency/、asyncio/、network/、database/、security/、extension/、llm/、hpc/、appendix/十个目录组织文档与 SKILL.md 的 Coverage Areas 完全对齐。这些.rst源文件经 Sphinx 构建make build见根目录 Makefile生成静态站点app.py 中的 Flask 应用则负责把构建产物docs/_build/html/安全地对外服务。8.2 可运行示例即正确性保障src/basic/下每个.py文件都对应一篇 cheat sheet 且可直接运行例如src/basic/dict.py↔ python-dict.rst演示setdefault/defaultdict、字典合并、用OrderedDict手写 LRU 缓存src/basic/generator.py↔ python-generator.rst覆盖yield from、向生成器send值、async generatorsrc/basic/object.py↔ python-object.rst覆盖__new__/__init__、描述符协议、MRO、__slots__。根目录 Makefile 的test目标会执行python -m pytest src/basic/*.py src/new_py3/*.py -v对全部示例进行断言校验——这意味着 Skill 所依赖的每个代码片段都是经过测试的进一步支撑了 battle-tested patterns 的说法。8.3 姊妹技能readable-py仓库还提供了第二个技能 skills/readable-py/SKILL.mdname: readable-py。它补充了 Skill 体系中代码整洁性的完整规则集函数保持 15–25 行、嵌套不超过 2 层、消除魔法数字、参数不超过 3 个、命名信息密度、注释解释 Why 而非 What以及为 auto-formatter 而设计等 19 条细则并附有大量正反示例。两个技能的分工清晰py负责找到正确模式readable-py负责把代码写可读。九、总结技能设计的三个可复用经验从skills/py/SKILL.md的完整设计中可以提炼出三条可复用于任何领域技能的经验正确性优先于风格通过强制查表获取机制让 Agent 的输出始终锚定在验证过的示例上而不是依赖模型记忆两级路由与深链主题地图structure.md负责粗粒度定位文档内部:ref:深链负责细粒度定位确保每个回答都有据可依规范与示例配套guidelines.md给出选型与质量标准docs/notes/与src/basic/提供可执行、可测试的落点二者结合才构成可用的技能闭环。如需进一步深入可直接阅读 skills/py/SKILL.md 原文或按 structure.md 的映射从 docs/notes/interview/index.rst 开始逐主题探索整套 cheat sheet。赞分享文档教程开发工具【免费下载链接】pysheeetPython Cheat Sheet项目地址https://gitcode.com/gh_mirrors/py/pysheeet点击查看免费下载相关推荐解锁Underscore.js集合操作的核心秘密从map到find的实战解析解锁Underscore.js集合操作的核心秘密从map到find的实战解析 Underscore.js作为JavaScript函数式编程的经典库其集合操作文档知识库Claude Agent SDK 完整实战指南用可编程 Agent 让 Claude 自主完成代码任务Claude Agent SDK 完整实战指南用可编程 Agent 让 Claude 自主完成代码任务 导读 本指南围绕 easy vibe 课程 stage教程文档人工智能Vibe CodingOpenClaw coding-agent Skill 实战指南把 Codex、Claude Code 与 OpenCode 编排为可信后台编码工人OpenClaw coding agent Skill 实战指南把 Codex、Claude Code 与 OpenCode 编排为可信后台编码工人 本指南围AI 应用AI Agent交互助手后端即时通讯网关上一篇XGLM-1.7B多语言能力深度解析支持30语言的AI模型实战指南 下一篇基于扩散模型的歌声转换项目推荐创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考