Python 类型约束与静态检查

原名：python-type-safety

用类型注解、协议和静态检查表达接口要求，识别 None、泛型与外部输入的风险。

中文 Skills 技能说明

Python 模块间传参经常出错时，可让开发岗位数字员工整理类型。提供版本、函数接口、数据样本和 mypy 或 pyright 配置，技能选择必要注解、Protocol 与泛型约束，交付类型改动建议和检查清单。不大量使用 Any 掩盖问题，也不把静态通过当作运行时校验通过；外部数据仍需验证。检查器需自有桌面环境，修改限定在获批文件中，先确认旧调用和测试兼容，生产接口变化由人审核。

上游能力依据

上游原始适用说明：Python type safety with type hints, generics, protocols, and strict type checking. Use when adding type annotations, implementing generic classes, defining structural interfaces, or configuring mypy/pyright.

上游 SKILL.md 主要章节（保留原文标题）：

• When to Use This Skill
• Core Concepts
• 1. Type Annotations
• 2. Generics
• 3. Protocols
• 4. Type Narrowing
• Quick Start
• Fundamental Patterns
• Pattern 1: Annotate All Public Signatures
• Pattern 2: Use Modern Union Syntax

使用边界

先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。

作者、翻译与许可证

原作者

Seth Hobson（wshobson）与 agents contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/wshobson/agents/tree/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/python-development/skills/python-type-safety

适用范围

平台：linux、macos、windows；标签：软件开发、Python 类型约束与静态检查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。