- name
- env-change-guard
- description
- 在修改环境变量或系统变量时，记录改了什么，并用电脑小白能听懂的话解释这次改动会带来什么影响。也适用于用户表示某个程序、命令、环境或系统功能出了问题，但又说不清具体原因时，优先从相关 log、报错信息或可见线索入手；如果日志相关，就先有限排查 log 内容，再继续正常排查其他可能原因，并用电脑小白能听懂的话解释。常用于 PATH、JAVA_HOME、Python、Node、ADB、Android SDK、OpenClaw 等环境相关场景。
环境变量变更记录与问题排查技能
这个技能主要做三件事：
- 记录这次改了什么
- 向电脑小白解释这次改动会有什么影响
- 当用户说某个程序、命令、环境或系统功能出了问题，但又说不清具体原因时，优先从相关 log、报错信息或可见线索入手；如果日志相关，就先有限排查 log 内容，再继续正常排查其他可能原因，并用电脑小白能听懂的话解释
使用要求
修改环境变量或系统变量时
要做到：
- 修改前先说明准备改什么
- 修改后明确记录改了什么
- 用简单的话解释这次改动会影响什么
用户说某个功能或环境出了问题时
要做到：
- 先看相关报错、log 或明显线索
- 先用简单的话解释目前看到的问题大概是什么意思
- 如果日志相关，就先有限排查 log 内容
- 然后继续正常排查其他可能原因
- 整个过程都尽量用电脑小白能听懂的话说明
记录要求
默认把环境变量变更记录写到：
logs/env-change-log.md
每次记录至少包含：
- 时间
- 改了哪个变量
- 修改前是什么
- 修改后是什么
- 为什么要改
给小白的解释方式
默认把用户当成不懂系统配置的人。
所以解释时要尽量简单，重点说清楚：
- 这次改的是哪个变量，或者当前问题大概出在哪里
- 它大概是干什么用的
- 改完以后哪些命令或程序可能会受影响
- 如果是报错，下一步还要继续看什么
- 是否需要重新打开终端、程序，或者继续检查其他可能问题
不要堆太多术语，不要写得像技术文档。
典型触发场景
- “帮我配环境变量”
- “把 Python 加到 PATH”
- “设置 JAVA_HOME”
- “配置 ADB / Android SDK”
- “改一下系统变量”
- “我不太懂，你解释简单一点”
- “这个报错是什么意思”
- “帮我查下日志”
- “看看是什么问题”
- “我看不懂这个错误”
- “你帮我排查下 XXX 出了什么问题”
完成前检查
结束前确认：
- 如果改了变量，已记录改动内容
- 已用简单语言解释影响
- 如果用户在排查问题，已先查看相关 log、报错或线索
- 如果日志相关，已先有限排查 log 内容
- 之后已继续说明其他可能问题