多环境配置
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-environment-variables。
技能介绍
多环境配置里常卡在什么地方
开发、测试、预发、生产各自一套变量和密钥,一旦靠口头约定或零散文档维护,很容易出现「本机对、CI 对、线上错」:漏配项、命名不一致、切换环境时改错文件。这类问题往往不是缺工具,而是没有可验收的交付标准和可逐项勾选的检查清单。
技能如何帮你结构化推进
本技能把「多环境配置」当成一条可重复执行的专业任务,围绕 SKILL 里定义的五种能力工作:
- 任务拆解:你给
目标 + 约束(例如必须区分 dev/staging/prod、不能进仓库的 secret),产出分步说明、交付物与验收条件。 - 模板生成:针对具体场景(
.env分层、K8s ConfigMap/Secret、多 profile 启动脚本等)给出可直接套用的文档或配置骨架。 - 检查清单:按「发布前 / 上线前 / 切换环境」列出分项核对项与优先级,减少靠记忆查漏。
- 方案对比:在 2~3 种做法(单文件多段注释、多文件按环境、集中配置服务)上拉利弊表并按维度打分,避免凭感觉选型。
- 复盘改进:用一次配置事故或误配数据写复盘单,落到改进行动与责任人。
通用工作流是先写清「交付物长什么样、做到什么算好」,再拆到今天能做的一步;选型时用维度(成本、周期、风险、可维护性)加权打分,并看敏感性是否会翻盘结论。
边界与注意点
产出是方法论、模板与清单参考,不替代安全合规或密钥治理的专业判断;不涉及接入付费配置中心、也不代管任何外部账号或 API 密钥。具体环境名、合规要求、轮转策略需由你在输入里写清约束,输出才会贴场景。
使用场景
- 新服务要区分 dev/staging/prod,需要把环境变量分层方案和命名规范一次写清并验收
- 上线前要把各环境必配项做成清单,逐项核对避免漏配数据库或第三方 API 地址
- 在「多 .env 文件」和「配置中心」之间选型,需要按成本与可维护性列出对比表再定方案
- 一次生产误用测试密钥后,要用复盘单归纳根因并列出下次发布前的防漏步骤
适合人员
- 负责发布流水线的后端工程师,想把各环境配置差异和发布前核对项固化成模板
- 小团队 Tech Lead,要在不引入付费配置中心的前提下统一多环境变量管理习惯
- SRE / 平台同学,需要给业务方一套「切换环境 / 上线前」可勾选的配置检查清单
- 曾发生过环境串配的事故负责人,希望用方案对比与复盘把选型理由和改进行动写下来