需要管理 AE 元数据数据表或绑定属性维度表时，用…

在 AE CLI 中需要 list/get/create/update/delete/download 元数据数据表，或把已有数据表/CSV 维度表绑定到属性时，使用本技能。

适用场景

解决思路

1. 先确认场景：需要 metadata data-table 的 list/get/create/update/delete/download、把已有数据表绑定到属性、或创建 CSV 维度表并绑定时，切到 ae-metadata。
2. 记住 metadata CLI 域路由到分析能力网关（/api/cli/analysis/v1/...），认证头使用 cli-token。
3. 本技能与 ae-analysis 并行；本技能只做网关支持的 metadata 详情与 data-table/dimension-table 操作，元数据 list/search、metrics、virtual create、batch edit 交给 ae-analysis。
4. 用 --format <json|table> 控制输出格式，默认 JSON。
5. 用 --jq <expr> 对 JSON 输出做 jq 过滤。
6. 用 --host <url> 覆盖当前 AE host，例如 ae-cli metadata data-table list --host <url> ...。
7. 迭代复杂 qp/payload 时单独使用 --validate 只修参数（/validate），确认后再运行；不要与 --dry-run 叠加。
8. 需要确认可运行或预览风险输出时单独使用 --dry-run（/dry-run）；不要与 --validate 叠加。
9. 成功时默认返回 JSON envelope，可能包含可选的 _notice.host_compat。
10. 失败时处理 { "ok": false, "error": { "type", "message", "hint" } }，并注意非零退出码。
11. 每次 ae-cli 运行后先检查 stderr 和 _notice.host_compat；若出现任一，在用户回复开头给简短 ⚠️ 版本警告，并逐字引用 npm i -g / npx skills add（或 update-cluster）行，然后再给业务结果。
12. 只读命令在验证 IDs/names 后可直接运行。
13. 普通写入（data-table *-write、property-bindings-update、dimension-table bind/create）无需 --yes 直接执行。
14. 删除命令属于 high-risk-write：先 dry-run，总结影响，等待明确确认，再用 --yes 执行。
15. 任何命令执行前先阅读匹配的 references/<name>.md；文件名等于命令中的空格替换为下划线，例如 metadata data-table list → metadata_data_table_list.md。
16. 永不臆造 project_id、事件/属性名、input_file_id、data_table_id；事件/属性名通过 ae-analysis 发现，data_table_id 通过 metadata data-table list 发现。
17. metadata data-table download 是异步产物命令：直接调用提交，--wait 等待，--output <file> 等待并原子流式输出；用 analysis run wait 恢复；本地中断不会取消远端运行。
18. 命令格式为 ae-cli metadata <resource> <action> [options]；属性维度表绑定用 ae-cli metadata property <dimension-table-action> [options]。
19. 命令和 flags 使用 kebab-case：data-table、dimension-table、--project-id、--data-table-id。
20. 网关 input body 字段保持 snake_case（project_id、event_name 等），ae-cli 会自动映射 flags。
21. PROJECT_ID_GATE 与 ae-analysis 相同：同一对话中复用已验证的 project 上下文；否则用 ae-cli project info list（或 ae-analysis skill）解析 project_id。
22. 可执行命令 metadata data-table list（capability id：metadata.data_table.list，参考 metadata_data_table_list.md）。
23. 可执行命令 metadata data-table get（capability id：metadata.data_table.get，参考 metadata_data_table_get.md）。
24. 可执行命令 metadata data-table csv-write（capability id：metadata.data_table.csv_write，参考 metadata_data_table_csv_write.md）。
25. 可执行命令 metadata data-table sql-write（capability id：metadata.data_table.sql_write，参考 metadata_data_table_sql_write.md）。
26. 可执行命令 metadata data-table csv-delete（capability id：metadata.data_table.csv_delete，参考 metadata_data_table_csv_delete.md）。
27. 可执行命令 metadata data-table sql-delete（capability id：metadata.data_table.sql_delete，参考 metadata_data_table_sql_delete.md）。
28. 可执行命令 metadata data-table download（capability id：metadata.data_table.download，参考 metadata_data_table_download.md）。
29. 可执行命令 metadata data-table property-bindings-update（capability id：metadata.data_table.property_bindings_update，参考 metadata_data_table_property_bindings_update.md）。
30. 可执行命令 metadata property bind-existing-dimension-table（capability id：metadata.property.bind_existing_dimension_table，参考 metadata_property_dimension_table_bind_existing.md）。
31. 可执行命令 metadata property create-and-bind-csv-dimension-table（capability id：metadata.property.create_and_bind_csv_dimension_table，参考 metadata_property_dimension_table_create_and_bind_csv.md）。
32. 快速验证命令：ae-cli metadata --help。
33. 快速验证命令：ae-cli metadata data-table list --help。
34. 快速验证命令：ae-cli metadata data-table list --project-id 1 --dry-run。
35. 快速验证命令：ae-cli analysis input-file purpose list --project-id 1。
36. 相关技能用法：ae-analysis 的 analysis-meta event get / property get 获取详情，analysis-meta event list / property list 发现名称。
37. 本地文件上传时切到 ae-analysis，使用 analysis input-file upload，并传入已发现的 purpose。
38. 绑定操作：把已有数据表绑定到属性，或创建 CSV 维度表并绑定，走对应 metadata property 命令。

适用边界 · 注意事项

• 需要 metadata 事件/属性详情、事件/属性/指标列表/搜索、指标 CRUD、批量 metadata、virtual create、项目配置或 tracking plans 时，不要用本技能，留在 ae-analysis。
• 需要本地文件上传时，不要用本技能，切到 ae-analysis 执行 analysis input-file upload。
• 未安装/不可用 ae-cli、AE 分析网关或 cli-token，或未验证 project_id/事件属性名/data_table_id/input_file_id 时，不适用。