用途:该技能用于审查 Python 代码的语言和运行时约定,不负责范围选择(diff 与代码库)、安全分析或架构分析,这些由范围和 cognitive 等技能处理。
主要能力:覆盖八个维度——类型提示(typing、Optional、Union、泛型,尽量避免 Any)、异常处理(捕获具体异常、raise ... from、避免裸露 except:、try/finally)、异步/await(避免异步函数中的阻塞调用、正确使用 asyncio.gather、create_task)、上下文管理器(with、enter/exit、@contextmanager)、依赖管理(固定依赖、避免 import *、虚拟环境)、可变默认值(避免 def foo(a=[]):)、PEP8 命名(snake_case、PascalCase、SCREAMING_SNAKE_CASE)和可测试性(避免全局状态、依赖注入、模拟友好设计)。
使用方式:由调用者提供代码范围(文件、目录或 diff),该技能仅接受范围作为输入,不对其做决定。输出为结果列表,每条包含位置、类别 language-python、严重性、标题、描述和可选建议,并带 file:line 引用。适合作为编排式审查(orchestrate-code-review)的语言步骤,或用于 PR 前检查 Python 语言与运行时质量。
限制:不执行安全、架构或范围分析;不检查非 Python 文件的 Python 规则,除非明确在范围内;不给出无具体位置或可行建议的结论。发现安全问题时应记录并建议 review-security,需要全面审查时重定向到审查代码。安装命令与具体运行方式暂未提供。