env-check
Installation
SKILL.md
Env Check
Read-only health inspection of the local development environment. Diagnoses "can it run", never tunes performance, never scans for threats, and never executes a fix — every finding carries a fix command for the user to run themselves.
中文速览(Quick Guide)
- 做什么:对开发环境做只读体检(六维:工具链/环境变量/WSL 互操作/磁盘与 inode/端口占用(--ports 指定)/依赖完整性),产出
[级别] 标题+证据+修复命令的报告与--json机读版。 - 何时用:「我这里跑不起来/明明装了却找不到命令」「代理挂着但装不动包」「WSL 里命中了 Windows 侧的二进制」等环境类问题。
- 核心步骤:跑
scripts/env-check.py(自测先过--selftest)→ 逐条读 FAIL/WARN → 把fix:行的命令原样给用户确认执行(本技能永不代执行)→ 需要平台细节查references/。 - 国内可达性边界:全部检测本地完成、零依赖零网络(代理连通性探测是对用户已配置代理的本机端口探测);无外链、无下载。
When to Use
- A build or install fails with environment-flavored symptoms:
command not foundfor an installed tool, wrong binary version, proxy timeouts. - User asks for an environment checkup / "体检" / "为什么我这里跑不起来".
- On WSL: suspicious Windows-side shadowing (
/mnt/c/...binaries winning), CRLF churn.
NOT for: performance tuning (CPU/memory/disk speed), security scanning of code or dependencies, project config review, AI session health.