smartchart

This skill should be used when the user needs to query data, explore available data tools, or execute data operations using the smartchart CLI. Trigger when...

Security Scan

The skill's files and instructions consistently implement a thin wrapper around the smartchart CLI; nothing in the package requires unrelated credentials or installs, and the behavior matches the description.

Purpose & Capability

Name/description ask for running smartchart CLI operations and the package contains an instruction-only SKILL.md plus a small helper script that calls the `smartchart run_tool` subcommand — all requested functionality aligns with the stated purpose.

Instruction Scope

SKILL.md only instructs listing tools, fetching help, and running queries via the smartchart CLI; it does not instruct reading unrelated files, exfiltrating data, or accessing environment variables beyond normal CLI usage.

Install Mechanism

There is no install spec in the registry; SKILL.md recommends installing the `smartchart` Python package via pip (a standard instruction). The package itself does not download arbitrary code or include an installer.

Credentials

No environment variables, credentials, or config paths are declared or accessed by the script. The helper only invokes the `smartchart` binary and handles its output — requested privileges are minimal and proportionate.

Persistence & Privilege

Skill is not forced-always and does not request persistent elevated privileges or modify other skills; autonomous invocation is allowed (platform default) but not combined with broad access.

Assessment

This skill is a thin, coherent wrapper around a CLI; it looks safe in itself. Before installing or using it, confirm the provenance of the `smartchart` package you will install (pip install smartchart) and that the CLI is the legitimate tool you expect. The helper script executes whatever `smartchart` binary is on PATH, so installing an untrusted package named `smartchart` could be risky. Also check whether the CLI requires credentials or configuration (the skill doesn't declare any) and provide those only if you trust the service. If uncertain, try the tool in an isolated environment or review the upstream `smartchart` project's source first.

SmartChart 数据查询技能

SmartChart 是一个面向开发的数据应用开发平台，提供 CLI 工具用于执行数据查询和工具调用。

环境要求

• Python 已安装 smartchart 库（pip install smartchart）
• CLI 命令：smartchart

核心 CLI 用法

列出所有可用工具（数据集）

smartchart run_tool -n list_tool

输出所有在线数据集的名称（name）和备注（remark）。在执行任何具体工具前，先运行此命令了解可用工具。

查看具体工具的使用方法

smartchart run_tool -n help_tool -t <工具名>

查看指定工具的详细信息，包括：输入参数说明、SQL 模板、输出字段等。仅在 remark 中未说明参数用法时使用此命令。

执行具体工具

smartchart run_tool -n <工具名/数据集名> [--format {raw,json,array}] [<变量>=<值> ...]

• -n：指定数据集名称或 ID（必填）
• --format：输出格式，可选 raw（默认）、json、array
• 其他参数：按数据集定义传入变量值（具体参数名由 remark 说明或 help_tool 获取）

示例：

# 列出所有可用工具
smartchart run_tool -n list_tool

# 查询名为「固定数据集」的数据，以 JSON 格式输出
smartchart run_tool -n 固定数据集 --format json

# 查看「查询」工具的详细用法和参数（仅在 remark 未说明时使用）
smartchart run_tool -n help_tool -t 查询

# 查询名为「查询」的工具并传入变量
smartchart run_tool -n 查询 --format json

标准工作流程

1. 发现工具：执行 smartchart run_tool -n list_tool 获取所有可用数据集列表
2. 判断用法：若 remark 已说明参数调用方法，直接使用；否则执行 smartchart run_tool -n help_tool -t <工具名> 了解参数
3. 执行查询：用 smartchart run_tool -n <工具名> --format json <变量>=<值> 执行查询
4. 处理结果：解析 JSON 输出，展示给用户

输出格式说明

格式	说明
raw（默认）	原始数组形式，第一行为字段名
json	对象数组，每行是一条记录，包含行数统计
array	纯数组形式

脚本辅助

使用 scripts/smartchart_query.py 可以以编程方式调用 smartchart 工具并格式化输出，适合需要进一步处理数据的场景。

注意事项

• 若 smartchart 命令不存在，提示用户执行：pip install smartchart
• 子命令是 run_tool，不是直接使用 -n 参数（smartchart -n xxx 无效）
• 查询结果默认包含 INFO 日志行，使用 --format json 可获得结构化数据