用途:用于新机器、新 Phoenix 应用初始化,或修复损坏的本地/CI 环境。核心是带硬性门控(HARD-GATE)的搭建循环,每一步未通过则不得继续。
主要能力与流程:
- 工具链:确认 Elixir/Erlang/OTP 版本与 .tool-versions / .elixir-version 一致;按需执行 mix local.hex --force 与 mix local.rebar --force;复制 .env.example 为 .env,禁止提交密钥。
- 应用启动:依次执行 mix deps.get、mix ecto.create、mix ecto.migrate、mix test,全部本地成功后才算通过。
- CI:工作流需覆盖 mix format --check-formatted、mix credo --strict、mix test,项目使用 dialyzer 时还需 mix dialyzer;编辑工作流时 Actions 按 SHA 固定。
- 验证:编写或更新 SETUP_CHECKLIST.md,记录可用命令;确认未提交任何密钥、令牌或环境相关 URL,DATABASE_URL 等仅以脱敏形式记录。
使用方式:按阶段推进,遇到 ecto.drop、类生产数据库重置或 force-push 前需人工审批(HUMAN-IN-THE-LOOP)。该流程会加载 mix-tasks-generators、deployment-gotchas、testing-essentials 三个原子技能,分别负责 Mix/生成器、运行时配置与测试套件预期。
适用场景:Phoenix 项目环境搭建、CI 配置校验、本地环境排障。
限制:资料未提供具体安装命令之外的版本号、平台支持范围、收费信息或效果保证;端口/数据库冲突时仅记录脱敏连接信息,绝不提交含凭据的 URL。