环境变量变更记录与问题排查技能#

这个技能主要做三件事：

1. 记录这次改了什么
2. 向电脑小白解释这次改动会有什么影响
3. 当用户说某个程序、命令、环境或系统功能出了问题，但又说不清具体原因时，优先从相关 log、报错信息或可见线索入手；如果日志相关，就先有限排查 log 内容，再继续正常排查其他可能原因，并用电脑小白能听懂的话解释

使用要求#

修改环境变量或系统变量时#

要做到：

• 修改前先说明准备改什么
• 修改后明确记录改了什么
• 用简单的话解释这次改动会影响什么

用户说某个功能或环境出了问题时#

要做到：

• 先看相关报错、log 或明显线索
• 先用简单的话解释目前看到的问题大概是什么意思
• 如果日志相关，就先有限排查 log 内容
• 然后继续正常排查其他可能原因
• 整个过程都尽量用电脑小白能听懂的话说明

记录要求#

默认把环境变量变更记录写到：

• logs/env-change-log.md

每次记录至少包含：

• 时间
• 改了哪个变量
• 修改前是什么
• 修改后是什么
• 为什么要改

给小白的解释方式#

默认把用户当成不懂系统配置的人。

所以解释时要尽量简单，重点说清楚：

• 这次改的是哪个变量，或者当前问题大概出在哪里
• 它大概是干什么用的
• 改完以后哪些命令或程序可能会受影响
• 如果是报错，下一步还要继续看什么
• 是否需要重新打开终端、程序，或者继续检查其他可能问题

不要堆太多术语，不要写得像技术文档。

典型触发场景#

• “帮我配环境变量”
• “把 Python 加到 PATH”
• “设置 JAVA_HOME”
• “配置 ADB / Android SDK”
• “改一下系统变量”
• “我不太懂，你解释简单一点”
• “这个报错是什么意思”
• “帮我查下日志”
• “看看是什么问题”
• “我看不懂这个错误”
• “你帮我排查下 XXX 出了什么问题”

完成前检查#

结束前确认：

• 如果改了变量，已记录改动内容
• 已用简单语言解释影响
• 如果用户在排查问题，已先查看相关 log、报错或线索
• 如果日志相关，已先有限排查 log 内容
• 之后已继续说明其他可能问题