用途:该技能面向 Semantic Link Labs 项目,用于检查代码风格、运行 linter、格式化代码以及修复格式问题,确保代码符合项目标准。
主要能力:覆盖三类工具。black 负责代码格式化;flake8 负责风格检查;mypy 负责类型检查。三者均通过 pyproject.toml 配置。flake8 的 max-line-length 设为 200。mypy 对 sempy.、Microsoft.、System.* 等模块设置 ignore_missing_imports = true。
使用方式:格式化可运行 black src/sempy_labs tests,检查用 black --check,查看差异用 black --diff,也可指定单个文件。风格检查运行 flake8 src/sempy_labs tests,可加 --show-source 或 --statistics。类型检查运行 mypy src/sempy_labs,可加 --show-error-codes。提交前建议依次执行 black、flake8,mypy 为可选。
常见问题:flake8 常见错误包括 E501 行过长、F401 未使用导入、F841 未使用变量、E302/E303 空行问题、W291 行尾空格、E711 与 None 比较。mypy 常见错误包括类型不兼容、缺少 return、参数类型错误、属性不存在;误报可用 type: ignore 注释。导入应按标准库、第三方、本地应用分组并用空行分隔。
适用场景:适用于该项目开发者在提交代码前统一风格、修复 lint 错误、验证类型正确性,以及配置 VS Code 保存时自动格式化。
限制:资料仅针对 Semantic Link Labs 项目,未提供其他项目的适配说明;未提供安装命令、版本要求或收费信息。