用途
ae-metadata 是 AE CLI 的元数据能力网关技能，用于通过命令行对网关支持的数据表和属性维度表进行操作。其命令路由到分析能力网关（/api/cli/analysis/v1/...），并使用 auth header cli-token 认证。
主要能力
该技能的能力契约覆盖数据表管理与维度表绑定，具体包含以下 10 个命令：
metadata data-table list（metadata.data_table.list）metadata data-table get（metadata.data_table.get）metadata data-table csv-write（metadata.data_table.csv_write）metadata data-table sql-write（metadata.data_table.sql_write）metadata data-table csv-delete（metadata.data_table.csv_delete）metadata data-table sql-delete（metadata.data_table.sql_delete）metadata data-table download（metadata.data_table.download）metadata data-table property-bindings-update（metadata.data_table.property_bindings_update）metadata property bind-existing-dimension-table（metadata.property.bind_existing_dimension_table）metadata property create-and-bind-csv-dimension-table（metadata.property.create_and_bind_csv_dimension_table）
输入方面，需要已验证的项目、表或属性标识符以及各操作对应的参数；本地 CSV 工作流需要有效的已上传输入文件标识符和用途。输出方面，返回表或绑定操作结果、资源标识符，或下载任务/产物状态；已提交的异步下载并不等于文件已完成。
使用方式
命令格式为：
ae-cli metadata <resource> <action> [options]
ae-cli metadata property <dimension-table-action> [options]
命令与参数使用 kebab-case，例如 data-table、dimension-table、--project-id、--data-table-id；网关请求体字段仍为 snake_case（如 project_id、event_name），ae-cli 会自动映射。
全局参数包括：--format <json|table>（输出格式，默认 JSON）、--jq <expr>（对 JSON 输出做 jq 过滤）、--host <url>（覆盖当前 AE host）、--validate（仅修正参数，不与 --dry-run 叠加）、--dry-run（确认可运行，单独用于风险/输出预览，不与 --validate 叠加）。
成功后默认返回 JSON envelope，可能包含可选的 _notice.host_compat；失败时返回 { "ok": false, "error": { "type", "message", "hint" } } 并以非零码退出。
关键约定：每次 ae-cli 运行后检查 stderr 和 _notice.host_compat，若存在，需在回复开头给出简短的版本警告并原样引用 npm i -g / npx skills add（或 update-cluster）行，然后呈现业务结果。
安全方面：只读命令在验证 ID/名称后可直接运行；普通写操作（如 data-table *-write、property-bindings-update、dimension-table bind/create）无需 --yes 即可执行；删除命令属于高风险写操作，需先 dry-run、总结影响、等待明确确认后再带 --yes 执行。执行任何命令前应先读取对应的 references/<name>.md（文件名 = 命令中空格替换为下划线）。不得编造 project_id、事件/属性名称、input_file_id 或 data_table_id；应复用已验证名称或通过元数据查找能力获取，数据表 ID 可通过 metadata data-table list 查找。
下载命令为异步产物命令：普通调用即提交，--wait 等待完成，--output <file> 等待后原子化流式写入。可用 analysis run wait 恢复等待；本地中断不会取消远端运行。
快速验证示例：
ae-cli metadata --help
ae-cli metadata data-table list --help
ae-cli metadata data-table list --project-id 1 --dry-run
ae-cli analysis input-file purpose list --project-id 1
适用场景
适用于用户需要元数据数据表 list/get/create/update/delete/download，或将已有数据表绑定到属性、创建并绑定 CSV 维度表的场景。对于本地上传，需先通过可用的上传能力获取带所需 purpose 的输入文件标识符，再继续表操作。
限制
该技能不覆盖本地输入文件上传、事件/属性详情与发现、指标 CRUD、虚拟元数据、批量元数据、项目配置和追踪计划，这些属于独立能力。当剩余工作超出本技能范围或需要其他能力作为前置条件时，应遵循协作协议，从本次运行中按能力选择其他技能，保留已验证上下文并继续任务。