用途:该技能定义 Python 工程的现代标准,用于两种模式——BUILD(按标准编写或修改代码)与 AUDIT(对照标准审查现有代码并报告问题)。详细规则位于 rules/*.md,需先完整阅读 SKILL.md,再按索引表按需加载规则文件。
主要能力:默认技术栈为 uv 管理环境与依赖(提交锁文件)、ruff check --fix 与 ruff format、一个严格类型检查器、公共接口完整注解、信任边界使用 pydantic v2、内部使用 frozen+slots 数据类、pathlib、惰性 % 日志格式化。异步遵循 TaskGroup 作用域、协程内无阻塞调用、外部 await 设超时、不产生未引用 create_task。安全默认开启:参数化 SQL、argv 列表子进程、secrets 生成令牌、安全解压、不对不可信数据使用 pickle/eval。测试使用 pytest、fixture 与 parametrize,不变量代码用 hypothesis。性能上默认选对数据结构,超出需先做性能剖析。
使用方式:BUILD 时先检查 pyproject.toml、uv.lock、.python-version、ruff 配置与类型检查器,匹配项目下限;新项目按 rules/01 用 uv init、src/ 布局、ruff 标准 select、严格检查器、pre-commit 脚手架。完成前运行 ruff check、类型检查器与测试套件(uv run)。AUDIT 时先机械扫描,例如 uvx ruff check --select F,B,S,ASYNC,DTZ,E722,BLE --statistics .、uvx bandit -r src/ -ll,以及 uv export --format requirements-txt --no-emit-project | uvx pip-audit --disable-pip -r /dev/stdin;再阅读设计层面(信任边界、异常策略、异步任务归属、N+1、缓存失效、测试独立性)。每条发现需打开文件核实上下文,不凭 grep 输出下结论。
严重级别:CRITICAL(可立即利用或数据丢失)、HIGH(有前置条件可利用或生产破坏性缺陷)、MEDIUM(正确性/维护风险)、LOW(偏离 SOTA)、INFO(值得知晓)。发现格式含严重级别/置信度、标题、文件行号、问题、证据、修复与工作量,按严重级别分组,CRITICAL 优先,末尾给出各级计数、已运行命令与“已检查且干净”的区域。
适用场景:新建或改造 Python 项目、代码审查、安全与供应链审计、异步与性能问题排查。
限制:资料未提供该技能的安装命令、收费方式、支持平台或具体版本兼容范围;规则文件内容需按索引自行加载,本介绍未展开全部细节。