用途:对项目 Python 代码做质量检查。默认只检查最近修改的文件,也可通过 --all 检查 synapse/ 目录下全部文件;检查顺序为 ruff、mypy、pytest,全部通过后默认运行代码简化智能体,可用 --no-simplify 跳过。
主要能力:ruff 静态检查并可用 --fix 自动修复;uv run mypy 做类型检查;--test 或 --full 时在检查通过后运行 pytest(pytest 或 pytest tests/ -v)。
用法:/code-quality [选项]。--all 或 -a 检查全部文件;--no-simplify 跳过简化;--fix 或 -f 自动修复 ruff 问题;--test 或 -t 运行测试;--full 等于 --fix --test。命令别名:/lint、/check,选项写法相同。
适用场景:提交前检查近期改动、修复 lint 问题、验证类型与测试,并在通过后精简代码。
限制:项目配置来自 pyproject.toml,ruff 目标 Python 3.10、行长 88、规则 E,F,I,UP,B,SIM,忽略 E501、B008,排除 synapse/proto/a2a_pb2*.py;mypy 为 strict 模式并禁止未标注函数定义,测试与 proto 文件放宽或排除;pytest 使用 asyncio_mode: auto。出错时 ruff 先自动修复,剩余错误按 file:line 报告;mypy 报类型错误;测试失败则不进入简化步骤。该技能的具体安装与调用入口资料中未提供。