SuperAPI AI 工具集

develop-component

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:该技能面向 Keboola Connection 平台的 Python 组件开发,覆盖持续开发工作,包括实现功能、扩展 extractor/writer/application、添加增量处理等。

主要能力:讲解并遵循 Keboola Common Interface 与组件架构;维护配置 schema 与部署流程;组织生产级 Python 代码。可把特定任务委派给专门 agent:配置 schema 与 UI 工作交给 ui-developer(使用 options.dependencies、schema-tester、Playwright);代码审查交给 reviewer(输出按严重度分组的 TODO);组件报错或失败 job 交给 debug-component;测试交给 tester(datadir 测试、单元测试、mock)。

使用方式:新建组件时用 cookiecutter gh:keboola/cookiecutter-python-component 初始化,清理示例文件并创建组件专用 data/config.json,再按架构模式实现、测试、部署。架构上以 CommonInterface 为基类,run() 保持约 20-30 行编排逻辑并委派给命名清晰的私有方法;复杂集成拆到独立客户端文件;用生成器处理 CSV;错误按退出码区分用户错误(1)与系统错误(2);实现状态管理以支持增量;为输出表定义显式 schema。代码质量要求:ruff format . 格式化、ruff check --fix . 检查修复、补全类型注解、不访问 self 的方法加 @staticmethod,并检查 IDE 类型告警。标准文件(pyproject.toml、Dockerfile、docker-compose.yml、.github/workflows/push.yml、scripts/build_n_test.sh、.pre-commit-config.yaml)应来自 component-defaults 模板。

适用场景:开发与维护 Keboola Python 组件、集成 Keboola API、部署到 Developer Portal、编写与调试测试。

限制:资料为工作流与规范指引,未提供具体收费、价格、平台或效果信息;实际需以官方开发者文档为准。