Community研究与数据分析github.com

CodeSigils/py-review-skill

可移植的Python代码审查技能集,适用于 agentskills.io 兼容的智能体——包含路由器及专注类型安全、错误处理、反模式、异步和代码风格的专项技能。

py-review-skill 是什么?

这个技能为AI编码智能体(如Claude Code、Cursor、Codex等)提供了可移植的、基于规则的Python代码审查功能。它通过一个主路由文件(SKILL.md)和多个专项技能模块(如类型安全、错误处理、异步模式等)的组合工作。智能体首先使用路由技能评估变更上下文(如Python版本、项目成熟度、工具链),然后动态加载或静态引用与变更代码匹配的专项技能规则。每个专项技能都包含详细的检查清单和规则,需要时按需激活。其主要价值在于:通过减少无关审查噪音来提高自动化代码审查的准确性,支持Legacy项目和Greenfield项目,并能适应pyright、ruff、mypy等不同工具链。输出结果按严重程度排序,优先关注错误和风险,而非代码风格。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add CodeSigils/py-review-skill

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Python Review Router

首先使用此技能进行Python代码审查。根据上下文进行定位,然后仅加载与变更代码匹配的专项技能。

审查前:定位

  1. 从 pyproject.toml、setup.cfg、tox.ini、CI 或 README 中检查 Python 版本。

    • 如果 >=3.10:加载所有相关的核心技能,但仅在规则对应的 Python/工具约束匹配时应用。
    • 如果 3.8-3.9:跳过需要 >=3.10 的语法规则。
    • 如果未知:假设最低为3.10,但对版本敏感的问题谨慎措辞。
  2. 分类项目成熟度。

    • 活跃/新项目:适用完整规则集。
    • 成熟遗留/仅维护项目:优先处理 CRITICAL 和 HIGH 级别的问题。
    • 自动化/脚本:优先关注安全性、正确性、资源处理和清晰的错误信息。
  3. 检查工具链。

    • 如果项目使用 pyright,不要推荐 mypy 特有的配置。
    • 如果项目使用 ruff,将样式/导入问题延迟到其配置处理。
    • 如果没有配置任何工具,工具建议应设为低严重性,除非问题与正确性相关。
  4. 先读取确切的变更文件,再标记问题。

    • 每个问题都要指出文件和行号。
    • 不要在没有本地证据的情况下提出泛泛的问题。
    • 规则匹配是信号,而不是最终结论。

路由

变更代码涉及...加载何时跳过...
注解、Any、类型转换、泛型、Protocol、公共APIpy-type-safety变更是琐碎的且没有类型相关表面
异常、验证、清理、重试、批量失败py-error-handling未变更失败路径
默认值、配置、资源使用、ORM/API边界、混合I/O/业务逻辑py-anti-patterns变更是文档/配置
async def、事件循环、FastAPI/httpx/aio*、任务、取消py-async-patterns项目/变更是同步的
格式化、命名、导入、文档字符串、lint/类型配置py-code-style工具输出已覆盖或审查仅需正确性

可移植性说明

“加载”列指示对每种变更类型应应用哪个专项技能的规则。如何访问这些规则取决于你的智能体运行时:

  • 动态加载:如果你的智能体支持在会话中途激活技能,请使指定的技能可被发现,并在路由表指示其范围时激活它。
  • 静态清单:直接从技能目录读取专项技能的 SKILL.md 文件,并将其规则作为审查清单应用。

两种方法产生相同的审查结果。路由表是决策树,专项技能提供规则集。

审查输出

以错误和行为风险为首。将仅涉及样式的问题放在正确性问题之后。对于遗留代码,优先选择可操作的高影响问题,而不是宽泛的现代化建议。

相关技能