SuperAPI AI 工具集

get-started

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:这是新建 Keboola Python 组件时的强制初始化工作流,要求在写任何代码之前先执行,确保组件基于统一的 cookiecutter 模板创建。

主要能力与流程: 一、检测状态。用 ls src/component.py component_config/ pyproject.toml 2>/dev/null 判断是否已初始化;若三者在场则跳过初始化,直接交给 @develop-component。若缺失或仓库为空,则继续下面的初始化。 二、收集组件信息。需要组件名称(kebab-case,不带类型后缀,如 ex-salesforce,而非 salesforce-extractor)、组件 ID(vendor.component-name 格式,如 keboola.ex-salesforce)、类型(extractor、writer 或 application)、一句话短描述。命名规则:名称中不得包含 extractor、writer 或 application;前缀约定为 extractor 用 ex-,writer 用 wr-。 三、运行 cookiecutter。若未安装,先 which cookiecutter || pip install --user cookiecutter,然后运行 cookiecutter gh:keboola/cookiecutter-python-component,以交互方式让用户确认取值。模板会生成 src/、component_config/、tests/、.github/workflows/、Dockerfile、pyproject.toml 以及带示例文件的 data/。 四、清理与配置。执行 find data -type f -delete 删除模板自带的通用示例文件,再用 mkdir -p data/in/tables data/in/files data/out/tables data/out/files 重建目录结构。随后创建 data/config.json,写入贴合组件实际功能的真实示例参数,而不是通用占位符;若 component_config/configSchema.json 已有内容,参照其中必填字段填入合理示例值,敏感字段用 # 前缀(如 "#api_key")。 五、首次提交。git add -A 后执行 git commit -m "feat: initialize component from cookiecutter template"。 六、交接。初始化完成后交给 @develop-component 开始实现,并说明该组件的用途以提供上下文。

适用场景:任何新建 Keboola Python 组件的起点阶段,尤其是空仓库或尚未建立 cookiecutter 结构时。

限制与说明:该技能不包含实现逻辑,仅负责初始化与交接;具体组件功能、模板内部字段含义、收费与平台支持等信息资料未提供。相关资源包括模板 gh:keboola/cookiecutter-python-component、开发者门户 https://components.keboola.com/ 与组件教程 https://developers.keboola.com/extend/component/tutorial/。