用途:针对带有配置同步目录的 Drupal 9/10 项目,运行内置脚本 scripts/extract_data_dictionary.py,把导出的配置转换为 Excel 数据字典,记录所有字段定义。
主要能力:在项目根目录(即包含同步目录的目录)生成五个 .xlsx 文件:{prefix}-content-types.xlsx、{prefix}-taxonomy-vocabularies.xlsx、{prefix}-block-types.xlsx、{prefix}-media-types.xlsx、{prefix}-paragraph-types.xlsx。
使用方式:运行前先向用户确认两项信息——同步目录(Drupal 配置导出目录相对项目根的路径,默认 sync)和输出前缀(用于命名输出文件的短标识,建议用项目或站点名,默认 az-gov)。确认同步目录存在;若当前工作目录不是项目根,需查找或询问用户。检查依赖:python3 -c "import openpyxl, yaml",失败则执行 pip install openpyxl pyyaml。随后在项目根运行:cd /path/to/project/root && python3 {skill_base_dir}/scripts/extract_data_dictionary.py --sync-dir {sync_dir} --prefix {prefix}。最后报告生成的五个 .xlsx 文件及其位置。
适用场景:需要为 Drupal 项目整理字段文档、交付数据字典时使用。
限制:仅适用于 Drupal 9/10 且存在配置同步目录的项目;依赖 Python 的 openpyxl 与 pyyaml;其他环境或非配置导出数据暂未提供支持说明。