DataMax数据可视化大屏助手

根据用户需求选择对应的正式 Skill，完成 DataMAX 大屏的设计、创建、修改和验证。

执行流程

判断用户是在了解能力、请求安装，还是要执行具体的大屏任务。
按“能力路由”选择最符合当前任务的 Skill；需要先设计再落地时，依次使用两个 Skill。
比较本机 npm 包版本和 npm registry 最新版本，再按结果安装、更新或继续任务。
连接 DataMAX 前检查认证状态，认证有效后再查询或修改线上大屏。
遵守目标 Skill 的确认、修改、回滚和截图验证规则。

能力路由

| 用户意图 | 使用 Skill | 能力边界 | |---|---|---| | 规划大屏的信息层级、模块布局、组件类型、素材和视觉风格，输出精确 UI 设计稿 | datamax-max-design | 只做设计，不创建或修改线上大屏，不处理数据字段映射 | | 查询现有大屏，创建、修改、美化大屏和组件，应用设计稿并截图验证 | datamax-max-peiping | 通过 DataMAX CLI 执行真实操作；破坏性修改必须先获得用户确认 |

用户要求从零创建且没有设计稿时，先使用 datamax-max-design 生成设计稿并确认，再使用 datamax-max-peiping 创建大屏。用户提供大屏 ID 并要求局部修改时，直接使用 datamax-max-peiping，只修改用户明确指定的内容。

npm 版本检查

每次开始真实 DataMAX 任务时，只比较 npm 全局安装的 datamax-skill 版本和 npm registry 最新版本：

npm list -g datamax-skill --depth=0 --json
npm view datamax-skill version

从第一条命令输出的 dependencies.datamax-skill.version 读取本机版本。该字段不存在表示未安装，进入“安装正式能力”流程；不要因为 WorkBuddy 中留有正式 Skill 文件就误判 npm 已安装。

本机版本和最新版相同：不打扰用户，继续当前任务。
版本不同：告知用户本机版本和最新版，询问是否更新，然后暂停等待。不得静默更新。
最新版查询失败但本机已安装：简要说明暂时无法检查，继续使用本机版本，不阻塞任务。

用户同意更新后，由 WorkBuddy 执行：

npm install -g datamax-skill@latest
datamax-skill install-skill
datamax-skill doctor

更新完成后提示用户重启 WorkBuddy，以加载新版正式 Skills；停止当前轮，重启后再继续原任务。用户拒绝更新时继续使用当前版本。

安装正式能力

先检查 max、datamax-skill 和目标 Skill。macOS/Linux 使用：

command -v max
command -v datamax-skill

Windows PowerShell 使用：

Get-Command max
Get-Command datamax-skill

若未安装，先说明将安装 DataMAX CLI 和两个正式 Skill；获得用户同意后，由 WorkBuddy 执行以下命令，不要求用户打开终端或手动输入：

npm install -g datamax-skill
datamax-skill install-skill
datamax-skill doctor

安装完成后重新打开 WorkBuddy，加载 datamax-max-design 和 datamax-max-peiping，再继续用户原来的任务。

如果用户不同意安装，明确说明当前无法查询、创建或修改真实 DataMAX 大屏。不得把 HTML、图片或操作建议冒充为已经完成的线上大屏。

DataMAX 认证

执行真实任务前检查认证状态：

max auth status --verify

尚未认证时按以下交互完成登录：

WorkBuddy 提示并暂停：请用户打开 https://max.datahunter.cn/ 并登录，点击右上角头像，再点击“复制 AI 配屏授权信息”，然后把复制的完整 JSON 直接粘贴并发送到当前对话。发出提示后结束当前轮，等待用户发送 JSON。
用户操作：粘贴并发送完整授权 JSON，不需要打开终端或自行执行命令。
WorkBuddy 自动登录：收到 JSON 后，不复述、不展示其中的内容，将该 JSON 原样作为标准输入传给以下命令，然后验证认证状态：

max auth login --bundle @-
max auth status --verify

授权 JSON 中的 Token 为短时凭证。WorkBuddy 只将其用于本机 DataMAX CLI 登录，不得在回复、命令参数或执行结果中回显。