AIGate

在 push 之前阻止有风险的 AI 生成 Git 变更。

English | 한국어 | 日本語 | 中文

HTML overview: https://leehueeng.github.io/aigate-ai-git-workflow-guard-cli/

AIGate 是面向 AI 辅助开发的 zero-config pre-push safety CLI。它会在变更进入 remote branch 或 PR review 之前，检查 changed files、secret 风险、仓库准备度、 PR 风险和 branch strategy。

适合使用 AIGate 的场景

• AI coding assistant 修改文件的速度快过你的 review。
• 你想在 git push 前用一个 command 说明 readiness。
• 你维护公开 package，需要 PR、release 和 repository health signals。
• 你需要 Markdown、HTML、JSON、SARIF output 同时用于 local 和 CI。
• 你希望 Codex、Gemini、Claude Code 遵循与人类相同的 branch/validation workflow。

60 秒快速开始

无需安装即可运行:

npx -y aigate-cli check
npx -y aigate-cli start --route default --dry-run
npx -y aigate-cli start --route quickstart --dry-run
npx -y aigate-cli doctor
npx -y aigate-cli test
npx -y aigate-cli ai report
npx -y aigate-cli demo
npx -y aigate-cli pr-check
npx -y aigate-cli evaluate-project

也可以全局安装:

npm install -g aigate-cli
aigate start
aigate start --route default --ask-steps
aigate start --route default --steps init,repo-files
aigate start --route oss --dry-run
aigate reset --dry-run
aigate clean
aigate uninstall
aigate check
aigate test
aigate ai report
aigate aitest
aigate git-ready
aigate install-hook --pre-push
aigate pr-check

强制连接模型

AIGate 不是只作为建议命令运行时最有价值，而是在接入 workflow 后最有价值。 实际保护级别分为三种。

• advisory: 开发者仍然可以忽略 AIGate 并直接运行普通 git push。
• partial: 当前 clone 中 hook 已激活，但仍可被 --no-verify 绕过，并且新 clone 中可能未激活。
• server enforced: CI 运行 aigate git-ready，并且已验证的 branch protection 或 MR merge rule 要求 CI 通过。

aigate doctor 会用 AIGate enforcement 报告当前级别。 aigate evaluate-project 会分别检查 AIGate CI gate exists 和 AIGate server enforcement exists。在 GitLab 中，allow_failure: true 或 when: manual job 不会被视为强制执行。由于 core.hooksPath 是每个 clone 自己的设置，AIGate 会分别显示 active local hook、已提交 hook file、hook activation automation。--gitlab-pipeline-must-succeed true 这类值只会被视为 declared evidence； 只有标为 verified 的证据才会判定为 server enforced。存在 CI gate 但缺少已验证的 server enforcement 时，evaluate-project 会在 JSON 中保留原始分数，并把最终分数限制在 A 等级以下，避免警告被分数掩盖。

场景式使用手册

| 场景 | 流程 | 命令 | | --- | --- | --- | | 接入新仓库 | 逐步创建 AIGate 基础文件，然后安装 pre-push guard。 | aigate start --route default --ask-steps -> aigate doctor -> aigate install-hook --pre-push | | AI 修改了很多文件 | 检查 changed paths，运行测试，并把失败内容整理成 AI 修复提示。 | aigate check -> aigate test -> aigate aitest --provider codex | | PR 即将提交 | 通过 gate，经 AIGate push，再生成 reviewer 摘要。 | aigate git-ready -> aigate push -u origin feature/my-work -> aigate pr-check | | private GitLab monorepo | 固定 profile，检测 turbo runner 后自动回退到 workspace tests，并把 GitHub/npm 包检查排除在 app 评分外。 | aigate setup --hosting gitlab --ci-provider gitlab --project-type app --package-manager pnpm -> aigate test -> aigate evaluate-project | | 开源发布 | 生成公开贡献文件，并检查仓库基础。 | aigate start --route oss --owner @team -> aigate evaluate-project --deep --report -> aigate github setup --dry-run | | 发布周 | 检查 npm 和 tag readiness，运行 CI 后记录趋势。 | aigate release-check --npm -> npm run ci -> aigate trends record |

当前可用功能

| 功能 | 命令 | | --- | --- | | 本地 Git readiness check | aigate check | | 引导式设置路由器 | aigate start | | 用是/否选择默认设置步骤 | aigate start --route default --ask-steps | | 只运行指定设置步骤 | aigate start --route default --steps init,repo-files | | 重置 AIGate 配置和 settings | aigate reset | | 删除生成的本地报告和状态 | aigate clean --force | | 移除 AIGate 配置、本地状态和自有 hook | aigate uninstall --force | | 公开仓库 README、issue 模板和贡献文件生成 | aigate start --route oss | | 检测 turbo runner 并回退到 workspace test | aigate test | | AI 修复提示和可选 agent 执行 | aigate aitest | | 汇总当前问题、做得好的部分和方向的 AI 报告 | aigate ai report | | 首次运行诊断 | aigate doctor | | 引导式 CLI demo | aigate demo | | pre-push safety gate | aigate git-ready | | pre-push hook installer | aigate install-hook --pre-push | | 带验证的 push wrapper | aigate push -u origin <branch> | | PR readiness report | aigate pr-check | | GitHub PR 摘要评论 | aigate github comment --pr <number> | | GitHub Checks 摘要 payload | aigate github check --format json | | GitHub PR 模板和 CODEOWNERS 设置 | aigate github setup | | Markdown, HTML, JSON, SARIF report | aigate report --format <format> | | repository health score | aigate evaluate-project | | server enforcement 实时验证 | aigate verify-enforcement --apply | | 合规控制报告 | aigate compliance-report | | 本地 HTML 健康仪表盘 | aigate dashboard | | 项目状态趋势历史 | aigate trends record | | 自动检测 private app、GitLab、pnpm，并排除 npm 包检查 | aigate setup --hosting gitlab | | 分支策略政策包 | aigate branch-strategy --apply | | 分支策略提案比较 | aigate branch-strategy --compare | | npm release readiness check | aigate release-check --npm | | Codex/Gemini/Claude integration files | aigate integrate all |

与其他工具的区别

AIGate 不强行替代 Husky、Lefthook、pre-commit 或 Gitleaks。它位于现有 hook 和 scanner 之上，把 AI-assisted changes 的 push safety、PR quality 和 repository governance 连接成一个 workflow layer。

详情见 tool comparison。

典型流程

git switch -c feature/my-work
aigate ai report
aigate start --route default --ask-steps
aigate start --route oss --dry-run
aigate start --route ai --provider all
aigate reset --dry-run
aigate clean
aigate doctor
aigate install-hook --pre-push
aigate test
aigate aitest
aigate git-ready
git add <files>
git commit -m "feat: focused change"
aigate push -u origin feature/my-work
aigate pr-check --output .aigate/reports/pr.md
aigate pr --title "feat: focused change"
aigate github comment --pr <number>
aigate github check --output .aigate/reports/github-check.md
aigate trends record
aigate github setup --owner @your-org/team --dry-run

语言设置

CLI 输出支持英语、韩语、日语和中文。

aigate setup --language en
aigate setup --language ko
aigate setup --language ja
aigate setup --language zh

GitHub Actions

其他仓库也可以把 AIGate 作为可复用的公开 GitHub Action 运行。

name: AIGate
on:
  pull_request:
jobs:
  aigate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: LeeHueeng/[email protected]
        with:
          command: git-ready
          language: zh

稳定运行请使用当前发布标签；只有在有意验证未发布的最新行为时才使用 @main。 完整输入见 GitHub Action 文档。

Action 发布状态:

• 当前稳定标签: v0.1.6
• Action 使用: 可通过 LeeHueeng/[email protected] 使用
• Marketplace 发布: 在 GitHub Release 页面手动启用
• Action name: AIGate Git Workflow Guard
• Primary category: Code quality
• Secondary category: Security
• Release title: AIGate AI Git Workflow Guard CLI v0.1.6

AI Agent 集成

aigate integrate all
aigate ai report
aigate ai report --apply --provider codex
aigate aitest --provider codex
aigate aitest --apply --provider codex

该命令会生成 AGENTS.md、GEMINI.md、CLAUDE.md 和 .aigate/integrations/*，让 Codex、Gemini、Claude Code 遵循相同的 branch、validation 与 guarded push workflow。aigate aitest 会把修复提示写入 .aigate/reports/ai-test.md；只有显式添加 --apply 时才会运行 Codex、 Claude、Gemini 或自定义 --agent-command。

aigate ai report 会汇总当前 Git 状态、仓库基础分、发布准备状态、分支策略和 AI 交接提示。默认不会修改文件；只有加上 --apply --provider codex|claude|gemini 时才会运行所选 AI CLI。

运行 --apply 时，AIGate 会在终端显示提示路径、provider、agent 命令和实时 agent 输出，并在最终报告中保留 stdout/stderr。

文档

• 多语言文档索引
• 中文使用指南
• 中文运维说明
• Tool comparison
• English operations guide
• 한국어 운영 문서
• 日本語運用ドキュメント
• Distribution guide
• Notifications guide
• AI integrations
• JSON output example
• Windows smoke test
• Release process
• Hotfix process
• Roadmap

公开安装渠道

现在可以使用这些公开安装路径。

npm install -g aigate-cli
brew install LeeHueeng/tap/aigate-cli
docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/leehueeng/aigate-cli:0.1.6 check

尚未发布的计划

• standalone binary
• hosted dashboard
• deeper Linear/Jira integrations

帮助 AIGate 成长

• 如果 AIGate 帮你拦下 risky push，请给 repository star 或 watch。
• 通过 issue 分享你在真实 repository 中的使用案例。
• 介绍项目时可以使用 demo GIF、terminal screenshot 或 assets/social-preview.png。
• 可以从 docs、examples、integrations、packaging 的 good first issue 开始贡献。

License

MIT