Agent Skills
返回列表
💻

开发环境统一编排

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2fd890c9/dev-env-manager。

技能介绍

要解决什么问题

本地与 CI 结果不一致、交接时说不清「到底装了啥版本」、多项目之间 Node/Python 版本互相踩踏——这些事往往不是缺 Docker,而是缺少一份可比对、可复现的环境声明与执行顺序。手动 diff 两份 .env 容易漏密钥口径;把 lint、test、build 写进一长串 shell 又很难在失败时快速定位是 ENV 还是任务依赖问题。

技能如何工作

dev-env-manager 面向 bash/zsh 日常操作,按项目根目录采集 .env、.nvmrc / .python-version、以及 package.json / pyproject.toml 中的脚本段,整理成带置信度标注的结构化输出(默认 JSON)。核心能力包括:

  • 环境快照:汇总工具链版本、环境变量与路径配置,便于交接或备份
  • 多版本切换编排:为不同项目绑定独立运行时版本(如 Node 14/16/18)
  • 环境差异比对:输出两套配置的增删改列表,辅助排查「本地能跑、CI 不行」
  • 任务链执行:按依赖顺序编排构建、测试、部署类命令,并配合错误码(如 ENV_004 版本声明冲突)
  • 配置漂移检测:对比实际环境与声明配置,发现未记录的临时修改

执行时会做敏感信息脱敏(密钥类仅保留首尾少量字符);无法可靠检测的字段会以 [需核实:...] 占位,整体置信度会受限并在备注中说明原因。

边界与注意点

本技能不会直接改写系统级 /etc 或注册表,也不能替代容器隔离或自动安装缺失 SDK——缺失工具只会提示安装方向。Shell 解析覆盖 bash/zsh 常见子集;Windows 与 POSIX 路径需自行适配。任务链执行前会检测依赖环,避免 A 依赖 B、B 又依赖 A 的死循环。

使用场景

  • 接手遗留仓库前,需要把当前机器上的 Node/Python 版本与 `.env` 导出成结构化清单给下一位维护者
  • 本地测试通过但 GitHub Actions 失败时,对比本地快照与 CI 日志中的环境声明找增删改变量
  • 同时维护三个使用不同 `.nvmrc` 的前端项目,要在进目录前确认该用哪套运行时
  • 发布前想把 `lint`→`test`→`build` 按依赖顺序跑一遍,并在某步失败时拿到明确错误码

适合人员

  • 维护多套 Node/Python 版本的前端工程师,需要为每个仓库绑定独立运行时而不是全局升级
  • 负责团队 onboarding 的技术负责人,想提供统一的环境模板并定期审计是否与成员机器漂移
  • DevOps 工程师在排查「同事机器能复现、自己不能」时,需要脱敏后的环境变量差异列表
  • 项目经理做合规抽查时,要对照声明配置与实际环境生成偏差报告