Back to Details

pudl

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PUDL Data and Metadata Guide

PUDL数据与元数据指南

Use this skill for data-user workflows: reading PUDL outputs, understanding table and field semantics, tracing source context, and interpreting methodology.
本技能适用于数据用户的工作流：读取PUDL输出结果、理解表格与字段语义、追踪数据源背景以及解读方法论。

Trigger phrases

触发短语

  • "show me this PUDL table in a notebook"
  • "how do I read table X from Parquet"
  • "load this table from local PUDL output"
  • "read this PUDL table from S3"
  • "what columns are in this table"
  • "what does this column mean"
  • "show table metadata for X"
  • "which data source does this table come from"
  • "find field descriptions for this table"
  • "I need notebook code to explore this PUDL data"
  • "在笔记本中展示这个PUDL表格"
  • "如何从Parquet读取表格X"
  • "从本地PUDL输出加载这个表格"
  • "从S3读取这个PUDL表格"
  • "这个表格包含哪些列"
  • "这个列是什么意思"
  • "展示表格X的元数据"
  • "这个表格来自哪个数据源"
  • "查找这个表格的字段描述"
  • "我需要笔记本代码来探索这些PUDL数据"

Audience and scope

受众与范围

  • Primary audience: analysts and data users, not core maintainers.
  • Focus: using outputs and metadata confidently without digging into internals.
  • Secondary audience: developers who need the same data context while coding.
  • 主要受众：分析师和数据用户，而非核心维护人员。
  • 重点：无需深入内部细节，即可放心使用输出结果与元数据。
  • 次要受众：编码时需要相同数据背景的开发人员。

Source-of-truth policy

权威数据源政策

The reference files in this skill are the canonical AI-facing layer for:
  • data access and output usage patterns,
  • table/field/source metadata retrieval,
  • source-doc and methodology interpretation.
pudl-dev
should reuse these references instead of duplicating them.
本技能中的参考文件是面向AI的权威层级，适用于：
  • 数据访问与输出使用模式,
  • 表格/字段/数据源元数据检索,
  • 源文档与方法论解读。
pudl-dev
应复用这些参考文件，而非重复创建。

Reference index

参考索引

  • Data Access and Outputs
  • Metadata and Querying
  • Data Sources, Dictionaries, and Methodology
  • 数据访问与输出结果
  • 元数据与查询
  • 数据源、数据字典与方法论

Escalation boundary

移交边界

If a task requires modifying ETL code, schema migrations, dbt tests, or CI workflow, hand off to 
pudl-dev
and keep these references as the shared data context.
如果任务需要修改ETL代码、模式迁移、dbt测试或CI工作流，请移交至
pudl-dev
，并将这些参考文件作为共享数据背景保留。