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 found for 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.

Hard Constraints

Installs
1
GitHub Stars
4
First Seen
Oct 25, 2026
Security Audits