当请求需要真实 OpenDataWorks 平台能力时使用：元数据查询、表/字段发现、数据源路由、血缘、DDL、只读 SQL 验证/执行、结果格式化或图表契约输出。不用于业务语义或 NL2SQL 推理。
当请求需要真实 OpenDataWorks 平台能力时使用：元数据查询、表/字段发现、数据源路由、血缘、DDL、只读 SQL 验证/执行、结果格式化或图表契约输出。不用于业务语义或 NL2SQL 推理。
npx skills add https://github.com/opendata-lab/opendataworks --skill opendataworks-platform-tools复制此命令并粘贴到 Claude Code 中以安装该技能
当请求需要 OpenDataWorks 平台通用业务语义时使用：元数据术语、工作流术语、血缘术语、平台指标定义、别名、歧义消解和业务规则例外。不用于领域专属本体、NL2SQL 方法或平台工具命令。
Use this built-in skill for chart construction and data storytelling from structured tabular results. The workflow is organized from the AntV chart-visualization playbook, but current default output is ECharts-compatible option JSON for local rendering.
Use this built-in skill for lightweight Python-based data exploration, profiling, aggregation, and file-based analysis. It does not fetch OpenDataWorks metadata on its own.
A minimal smoke skill used to verify that opendataagent can load bundled skills and surface them during chat.
Use this built-in skill for OpenDataWorks platform metadata, lineage, datasource resolution, and DDL lookup. This skill does not execute SQL for data analysis.
Use this built-in skill to execute readonly SQL through the OpenDataWorks agent API and shared odw-cli. Guardrails such as readonly checks, datasource scope, default limit, and timeout are enforced by CLI and API.
| name | opendataworks-platform-tools |
| description | 当请求需要真实 OpenDataWorks 平台能力时使用：元数据查询、表/字段发现、数据源路由、血缘、DDL、只读 SQL 验证/执行、结果格式化或图表契约输出。不用于业务语义或 NL2SQL 推理。 |
| compatibility | 需要 DATAAGENT_PYTHON_BIN、DATAAGENT_PLATFORM_SKILL_ROOT，以及可见的 portal MCP 工具或本技能 bin/odw-cli 的后端服务访问能力。 |
| tools | ["Bash","Read"] |
OpenDataWorks Platform Tools Skill。平台工具 Skill。
这是 OpenDataWorks 平台工具技能，提供真实平台能力：获取表、获取字段、获取血缘、获取 DDL、解析数据源、验证 SQL、执行只读 SQL、格式化结果和生成图表契约。
它不定义业务术语、本体、指标口径、别名、歧义规则或查询方法。业务含义交给语义技能，SQL 就绪规则由 DataAgent system prompt 约束。只有需要真实 OpenDataWorks 平台证据或执行时，才使用本技能。
负责：
sql_execution 和 chart_spec 工具输出契约。不负责：
"$DATAAGENT_PYTHON_BIN" "${DATAAGENT_PLATFORM_SKILL_ROOT}/scripts/<name>.py" ...DATAAGENT_SKILL_ROOT。INSERT、UPDATE、DELETE、DROP、TRUNCATE、ALTER、CREATE、REPLACE 或其他写语句。SELECT 查询默认带 LIMIT，除非已验证的语句类型不支持。export_query.py，让全量数据写工作区文件、只把路径与预览回给模型；不要用 portal_query_readonly 或 run_sql.py 把全量结果拉进上下文（会被结果字节守卫截断，且可能撑爆运行时缓冲）。reference/30-tool-recipes.md，确认具体平台能力路径。reference/40-runtime-metadata.md。reference/50-tool-output-contract.md。| 能力 | 使用场景 | 优先路径 |
|---|---|---|
| 获取表 / 获取字段 | 需要候选表、相似表、表注释、字段名或字段注释 | portal MCP 元数据搜索，失败再脚本回退 |
| 获取血缘 | 需要上下游证据或血缘诊断 | portal MCP 血缘查询，失败再脚本回退 |
| 获取 DDL | 需要实时表结构、字段顺序、分区、注释或建表语句 | portal MCP DDL 查询，失败再脚本回退 |
| 解析数据源 | SQL 执行前需要执行引擎/database 路由 | portal MCP 数据源解析，失败再脚本回退 |
| 验证 SQL | SQL 已就绪，准备脚本回退执行 | 验证脚本 |
| 执行只读 SQL | SQL 已验证通过，且需要真实结果 | 只读 SQL 执行脚本 |
| 导出结果到文件 | 结果行数多、或需落盘供后续 Python 处理（如生成 Excel） | 导出脚本 export_query.py，全量写工作区 CSV，只回路径+预览 |
| 图表契约 | SQL 结果形态适合前端图表渲染 | 图表契约脚本 |
基于结构化平台结果返回中文结论。不要编造平台数据。平台工具返回不可重试错误时，报告失败归因并停止，不要猜另一张表或另一个字段。