用途:在打开 PR 或需要完整质量/生产就绪检查时,执行一套带硬性门禁(HARD-GATE)的 Elixir/Phoenix 质量流程,覆盖格式、静态检查、类型分析、依赖审计、测试,以及在复杂度超标时的可选重构。
主要能力与阶段: 第一阶段(约定):运行 mix format --check-formatted、mix credo --strict、mix dialyzer、mix hex.audit、mix test,五者必须退出码为 0 才算通过;否则先修复违规再重跑。 第二阶段(可选重构):仅当复杂度超过阈值(函数 >20 行、参数 >4、模块 >400 行、嵌套 >3、管道链 >5)时触发。必须先有在当前代码上通过的 characterization test,每次只在授权任务范围内做一次有刻画测试的抽取(优先 FCIS 抽取,把纯模块从 LiveView/controller/worker 中分离),每次改动后重跑测试;若失败则回退并缩小抽取步骤。 第三阶段(文档):对触及的公开 API 添加 @doc 与 @spec,未完成前不得开 PR。
硬性门禁要点:所有质量命令退出 0;重构需有绿色刻画测试且不越授权范围;不得跳过门禁或凭模拟输出宣称通过;触及的公开 API 须有 @doc 与 @spec。输出为 Quality Report,包含各命令退出码表格、硬性门禁 PASS/FAIL、重构与文档清单及 APPROVE/REQUEST_CHANGES 结论。
限制与缺失:资料的官方文本为空;未提供安装方式、版本要求、收费信息、平台支持及具体配置参数,此类事实暂未提供。实际使用时须以真实命令输出为准,禁止以模拟结果判定门禁通过。