用途：为项目配置 DevOps 质量门禁，按项目类型适配，遵循 shift-left 理念——能在开发者机器上运行的检查就本地运行，GitHub Actions 只承担笔记本无法完成的部分，并保留一个廉价任务证明钩子未被绕过。
主要能力：按检查路由表把每项检查分配到唯一通道。pre-commit 阶段（每次提交，改动文件，10 秒内）做格式化、lint、类型检查、离线安全扫描、快速单元测试、编译/导入检查；pre-push 阶段（每次推送，全仓库，60 秒内）做完整测试套件、CLI 端到端测试、覆盖率阈值、较慢的 lint；GitHub Actions 只做版本矩阵、依赖密钥的扫描、覆盖率上传、部署/发布和绕过守卫。
使用方式：先分析项目（语言、框架、构建系统、已有工具、是否为 CLI），再生成 .pre-commit-config.yaml 与 .github/workflows/ci.yml。安装钩子需执行 pre-commit install 和 pre-commit install --hook-type pre-push，并用 pre-commit run --all-files 验证。CLI 项目生成 scripts/e2e_test.sh 并接入 pre-push。CI 的绕过守卫在 PR 上以 --from-ref/--to-ref 重跑两个阶段，需 fetch-depth: 0。
限制与安全：不得覆盖已有配置文件，需先备份、合并并让用户确认；安装前先 dry run；不得使用 -f/--overwrite；不得代跑 --no-verify；不得通过 SKIP、放宽规则或降低覆盖率来掩盖失败。未检测到技术栈、缺少 pre-commit 或 origin 时应停止并询问。测试超过 60 秒应降级到下一通道并注明原因。Windows 仓库需替换为 PowerShell 兼容条目。具体语言配置、工作流模板与 E2E 脚本见 references 目录。