mcpField
L
ln-733-env-configurator

ln-733-env-configurator

github.com/levnikolaevich开发584379 次安装2 天前更新
代码仓库

关于 ln-733-env-configurator

ln-733-env-configurator 是用于开发和生产环境配置的 L3 Worker。它根据项目中检测到的环境变量生成配置文件，并在 .gitignore 中加入秘密保护规则；不存储秘密，也不配置外部秘密管理器。

主要功能

  1. 01扫描代码中的环境变量
  2. 02分类秘密与普通配置
  3. 03生成三种环境配置文件
  4. 04为 .gitignore 添加保护规则
  5. 05仅使用占位值，不生成真实秘密

适用场景

  1. 01为项目建立环境变量模板
  2. 02准备本地开发环境配置
  3. 03为部署生成生产环境占位配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-733-env-configurator

安装后在 Claude Code 中输入/ln-733-env-configurator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/templates/
env_development.template
env_example.template
env_production.template
gitignore_secrets.template

详细介绍

路径： 文件路径（references/、../ln-*）均相对于此技能目录。

ln-733-env-configurator

类型： L3 Worker 类别： 7XX 项目引导

为开发和生产环境配置环境变量。

用途与范围

创建环境配置文件：

  • 会做： 生成 .env 文件，更新 .gitignore 以保护机密信息
  • 不会做： 存储机密信息、管理外部机密管理器、配置 CI/CD 机密信息

输入

输入来源描述
项目名称目录名称用于数据库/服务命名
后端端口取决于技术栈5000（.NET）、8000（Python）
前端端口默认值3000
数据库端口默认值5432
检测到的变量代码分析在代码中找到的环境变量

输出

文件用途模板
.env.example带说明的模板env_example.template
.env.development本地开发默认值env_development.template
.env.production生产环境占位值env_production.template
.gitignore（追加）机密信息保护gitignore_secrets.template

工作流

阶段 1：环境发现

扫描项目，查找现有的环境变量用法：

  • 检查是否存在 .env 文件
  • 在代码中搜索 process.env、os.environ、Configuration[]
  • 判断哪些变量属于机密信息，哪些属于配置项

输出： 所需环境变量列表及其类型

阶段 2：变量分类

对发现的变量进行分类：

类别示例处理方式
数据库DATABASE_URL、POSTGRES_*使用项目名称自动生成
API 配置API_PORT、LOG_LEVEL使用检测到的值或默认值
安全JWT_SECRET、API_KEY使用占位值并附带警告
外部服务REDIS_URL、SMTP_*注释掉，标记为可选
阶段 3：生成模板

根据模板生成环境文件：

  1. 替换变量
  2. 包含所有发现的变量
  3. 为未记录的变量添加注释
阶段 4：更新 Gitignore

向 .gitignore 追加机密信息保护规则：

  1. 读取现有的 .gitignore（如果存在）
  2. 检查是否已包含机密信息匹配规则
  3. 从模板中追加缺少的规则
  4. 保留现有条目

生成的文件结构

.env.example

包含所有变量并附有说明的模板：

  • 分节标题（数据库、后端、前端、安全、外部服务）
  • 每个变量的描述性注释
  • 安全的占位值（绝不使用真实机密信息）
  • 将可选变量注释掉
.env.development

可直接使用的开发配置：

  • 预填可与 docker-compose 配合使用的值
  • 仅用于开发的机密信息（明确标记）
  • 启用 Debug 级别日志
.env.production

生产环境占位文件：

  • 使用 ${VARIABLE} 语法进行部署替换
  • 注明所需机密信息的注释
  • 适用于生产环境的默认值（Warning 日志级别）

安全最佳实践

实践实施方式
不使用真实机密信息模板中仅使用占位值
Gitignore 保护除 .env.example 外，忽略所有 .env 文件
开发环境警告将开发环境机密信息标记为不安全
生产环境指南添加有关机密管理器用法的注释
密钥轮换提醒提醒定期轮换机密信息

安全注意事项

生成的文件包含以下安全提醒：

  1. 切勿提交真实密钥 - .gitignore 可防止意外提交
  2. 使用密钥管理器 - 在生产环境中使用 GitHub Secrets、AWS Secrets Manager
  3. 定期轮换密钥 - 尤其是 JWT 密钥
  4. 使用强 JWT 密钥 - 至少 256 位（32 字节）
  5. 限制 CORS - 在生产环境中仅允许必要的来源

质量标准

生成的文件必须：

  • .env.example 包含所有必需变量
  • 所有文件中均不包含真实密钥或密码
  • .gitignore 已更新，包含密钥匹配规则
  • .env.development 可与 docker-compose 配合使用
  • .env.production 使用占位符语法

重要注意事项

  1. 基于模板：使用 references/ 中的模板。切勿硬编码文件内容。
  2. 幂等：检查文件是否存在。向 .gitignore 追加内容，不要覆盖。
  3. 不使用真实密钥：切勿生成包含真实密码或 API 密钥的文件。
  4. 开发安全性：开发默认值应开箱即用，并可与 docker-compose 配合使用。

参考文件

文件用途
env_example.template带说明的 .env 模板
env_development.template开发默认值
env_production.template生产环境占位符
gitignore_secrets.template.gitignore 添加项

完成定义

  • 已生成 .env.example、.env.development、.env.production
  • 所有生成文件中均不包含真实密钥或密码
  • .gitignore 已更新，包含密钥保护规则

版本： 1.1.0 最后更新： 2026-01-10

评论

支持 Markdown