SuperAPI AI 工具集

pudl-dev

编程与开发

查看项目

更新于 10-15 17:32

技能介绍

用途:该技能用于 PUDL 项目中代码行为、元数据与数据产品紧密耦合的广泛开发任务,例如参与贡献、本地运行 PUDL、为某项改动选择命令、查找表元数据、验证数据变更、理解表与源文档的关系、确定 PR 需更新的文档,以及发布或运维 PUDL 构建。

主要能力:提供贡献者工作流(PR 流程、贡献规范、沟通与规划)、开发环境与 ETL(环境搭建、运行 ETL、datastore 上下文、本地执行)、测试与验证(pytest 范围、dbt 验证流程、质量检查)、元数据与 schema(元数据真源文件、dbt schema 耦合、迁移)、Dagster 与资产(项目结构与资产编排)、文档生成可追溯性(生成产物到构建钩子、模板与元数据类的映射)、发布与运维(发布流程、夜间构建上下文、运维文档)、ID 映射与实体链接(跨数据集实体匹配的历史与实践指导)。

使用方式:先根据参考索引确定主要工作流,回答前阅读相关参考文件;优先使用仓库原生命令(pixi run ...)与既有约定。专项工作流可配合相关技能:pytest、dbt、code-quality、alembic、pudl(偏数据访问)、dagster-expert。数据、元数据、来源与方法学指导集中在 pudl 技能中,应使用参考索引里的 Shared 条目而非在 pudl-dev 中重复维护。

限制:技能内文件是为编码代理提炼的,权威项目指导仍以 PUDL 文档与源代码为准,每个参考都指向权威文档。具体命令细节、版本要求与操作步骤暂未提供。