用途：在批准 PR 或合并到 main/dev 前，生成一份统一的绿/红检查报告，确认所有门禁通过。
主要能力：默认通过 Task shell 子代理运行 pre_merge_gate.py，主对话负责分诊 FAIL 行并重新委派修复。必需检查（目录存在时）包括：setup 审计（@heyeddi-setup verify_setup --check，偏好不完整即失败）、npm test 与生产构建（package.json）、存在 node_modules 时运行 vue-tsc --noEmit（前端存在但工具链缺失即 FAIL）、后端 pytest（backend/tests，优先 backend/.venv）、对 backend/app 运行 ruff F821、工程审计（@engineering-excellence audit_engineering --check，错误失败、警告仅提示）。可选检查（技能/工具缺失可 SKIP，但 FAIL 仍硬停止）：重复 UI 扫描、文案审计、产品路由对比度审计。
使用方式：运行 python .agents/skills/pre-merge-gate/scripts/pre_merge_gate.py --project-root <root>，阅读 markdown 报告中的 PASS/FAIL/SKIP，修复失败项并重跑直到退出码为 0。评估/测试框架单独捕获 Playwright 证据时，加 --skip-visual-audit。可用标志：--skip-duplicate-ui、--skip-prose-audit、--skip-engineering-audit、--skip-setup-audit、--skip-visual-audit；其中 --skip-backend、--skip-engineering-audit、--skip-setup-audit 仅限紧急情况，不得用于合并签核。
限制：脚本任一检查 FAIL 即退出 1；不得把退出码 0 的 markdown BLOCKED 报告视为可合并；除非进程退出 0，代理不得合并或声称可合并。完成后可运行 suggest_next_skill.py 获取下一步建议。