用途:在开始工作前判断一个仓库是否真的能跑起来,并指出缺什么。它基于项目自身的预期配置生成 ✓/✗ 清单,覆盖 localhost、staging、prod,而不是套用通用建议。目标是避免在运行时才发现缺少 .env 键或环境未接线。
主要能力:
- 发现应存在的内容:以 .env.example(或 env.example)作为环境变量契约;查看 README/CLAUDE.md 是否描述各环境配置;通过 make help、grep -E '^[a-z-]+:.##' Makefile、docker-compose.yml 或 package.json scripts 找到真实运行目标;确认本地栈是否需要 SSO/CLI 登录。
- 本地就绪检查:.env 是否存在且被 gitignore;.env.example 的每个键是否在 .env 中存在且非空(用 comm 对比键集合,而非目测);是否残留 changeme、xxx、TODO 等占位值;本地栈与依赖是否就绪;需要云服务时认证是否生效。
- staging 与 prod 接线检查:每个变量在对应环境配置源中是否有值;环境相关值是否按环境配置而非硬编码;密钥是否存在于密钥库且格式正确;部署路径是否文档化。这是静态契约检查,不执行部署。
- 报告:按环境分组输出紧凑清单,每个 ✗ 附上修复命令或修改;最后给出一行结论:本地能否运行、阻塞点是什么。若缺少环境文档,建议补充。
使用方式:作为技能调用,对目标仓库执行一次检查即可。资料未提供具体安装命令或调用参数。
适用场景:接手新仓库、开工前自检、排查环境配置遗漏、审查多环境接线。
限制与反模式:不要因本地通过就假设 staging/prod 一致;不要目测而应 diff 键集合;不要把未文档化的环境当作无需检查;报告中只报键名与是否存在,绝不打印密钥值。资料未提供收费、平台支持或效果数据。