SuperAPI AI 工具集

review-component

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:审查 Python 编写的 Keboola 组件代码与文档,不仅找 bug,还帮助代码与文档更清晰、可维护并符合 Keboola 组件最佳实践。默认审查 git diff 中未暂存的改动,用户也可指定其他文件或范围。审查时会参考 CLAUDE.md 或 AGENTS.md(若存在)、项目规则以及组件开发者指南。

主要能力与审查重点:按重要程度排序。阻断项包括架构违规(配置/客户端初始化、关注点分离)、文档中矛盾或误导性示例、意外改变行为的改动;重要改进包括 config-as-model 模式(用类型化对象封装配置)、现代类型语法(list[str] 而非 List[str],str | None 而非 Optional[str])、移除废弃类型、公共方法缺少类型提示;可选改进包括格式与风格一致性、导入组织及更 Pythonic 的简化。

使用方式:阅读 git diff 或指定文件、相关项目文档(CLAUDE.md、pyproject.toml),理解组件目的与架构后应用审查原则。发现问题按严重程度分组为具体可执行的 TODO,每条包含位置(文件路径与行号,如 src/component.py:45-52)、待修改的模式、具体修复建议。仅报告置信度≥60 的问题(0-25 低、26-50 中等、51-75 高、76-100 关键)。语气直接而友善,开头给简要评估,结尾可用 LGTM。例如导入排序可运行 ruff check --select I --fix src/component.py 自动整理。

适用场景:Keboola Python 组件的代码审查与质量把关。限制:审查模式基于 Martin Struzsky(GitHub @soustruh)风格,在 Keboola 组织 141 个 PR、521 条评论上训练;具体安装与运行方式暂未提供。