Env Manager

This scans your codebase for environment variables, finds mismatches between what's defined in .env files and what's actually used in code, and generates proper .env.example templates. It catches dead configs, missing variables, and hardcoded secrets that should be in env files instead. The framework-specific checks are genuinely useful, it knows about Next.js's NEXT_PUBLIC_ prefix rules, Vite's conventions, and the differences between Docker ARG and ENV. You get a clear report showing unused variables, missing definitions, and security issues like hardcoded API keys. Best used when onboarding new developers, before deploys, or when you suspect your env configuration has drifted from reality.

GitHub stars: 328
last updated: May 13, 2026

View on GitHub

Install

$ npx -y skills add laolaoshiren/claude-code-skills-zh --skill env-manager --agent claude-code

Installs into .claude/skills of the current project.

Files

环境变量管理器

触发条件

当用户要求管理环境变量、.env 文件、配置同步、Secrets 检查时激活。

工作流程

1. 扫描项目

检测所有 .env* 文件（.env / .env.local / .env.development / .env.production）
默认只提取变量名、来源文件和是否为空；真实值必须脱敏，不写入报告或终端输出
扫描代码中引用的环境变量（process.env.XXX / os.environ['XXX'] / os.getenv('XXX')）
识别静态扫描中未发现引用的变量（仅作为待人工确认候选）
识别已使用但未定义的变量（缺失配置）

2. 校验分析

检查必填变量是否有默认值
验证 URL 格式、端口号范围、布尔值格式
检测硬编码的敏感信息（API Key / Token / Password）
对比 .env.example 与实际 .env 文件的差异

3. 生成/修复

生成 .env.example 模板（仅包含变量名和说明，不含真实值）
生成 .env.schema.json（结构化校验规则）
检测到硬编码密钥时，建议迁移到环境变量
生成 dotenv 加载配置（针对不同框架）

4. 同步

在 monorepo 中同步共享环境变量
生成 Docker Compose 的 env_file 配置
生成 CI/CD 的 Secrets 配置清单

输出格式

.env.example 示例

# 应用配置
APP_NAME=my-app
APP_ENV=development          # development | staging | production
APP_PORT=3000                # 服务端口 (1-65535)
APP_DEBUG=true               # 调试模式

# 数据库
DB_HOST=localhost
DB_PORT=5432
DB_NAME=mydb
DB_USER=                     # 必填
DB_PASSWORD=                 # 必填，生产环境请使用 Secrets

# 第三方服务
REDIS_URL=                   # 必填，格式：redis://host:port
JWT_SECRET=                  # 必填，至少 32 位随机字符串

SKILL.md on GitHub