用途
该技能面向 Python 代码的工程化质量保障,适用于编写或编辑 Python 代码时的规范化处理。其定位是“代码是机制,提示词是策略”,即通过一套明确的策略约束来指导代码的生成与修改。
主要能力
技能提供四项工具能力:
- lint_python_style:使用 ruff/flake8 检查代码风格,配置目标为 py313。
- run_pytest:执行测试套件。
- check_types:运行 pyright 进行类型检查。
- format_python:使用 ruff/black 格式化代码。
编码规范(v2.0 - Modern)
在编写或编辑 Python 代码时,技能要求遵循以下标准:
- 状态管理:使用 StrEnum 替代魔法字符串。
- 控制流:优先使用 match/case,而非复杂的 if/elif 链。
- 类型安全:对继承方法使用 @override,并采用新的泛型语法 class Foo[T]。
- 并发:使用 asyncio.TaskGroup 替代 gather。
- 标准:遵循 PEP 8、4 空格缩进以及 Google 风格文档字符串。
完整标准参见 lang-python-modern.md。
使用方式
当需要 lint Python 代码、使用 ruff/black 格式化、运行 pytest 测试、使用 pyright 做类型检查,或按 Python 3.12+ 标准进行现代化改造时,可调用该技能。具体调用方式与集成细节暂未提供。
适用场景
适用于 Python 项目的日常开发与维护,包括代码风格统一、测试执行、类型检查以及向现代 Python 版本迁移等场景。
限制
关于该技能的安装方式、依赖要求、平台支持、收费模式及具体使用步骤,资料中暂未提供。