RepoGuard

产品简介

RepoGuard 是一款面向 AI 辅助编程的架构守护工具，专门解决 Cursor、Claude Code、GitHub Copilot、Windsurf 等 AI 编程助手"5 秒写 300 行代码却把项目结构搞成意大利面"的问题。它通过自动生成严格的项目规约文件、提交前校验、PR 审计三层机制，让 AI 写代码时严格遵守既有架构边界。

RepoGuard 以 npx 一键运行的 CLI 工具形式发布，同时托管在 npm（repoguard-rules），支持 TypeScript、Python、Golang 三大主流技术栈，免费版覆盖公共仓库与本地开发，企业版支持私有仓自动 PR 拦截。

核心功能

• 多 agent 规约生成：自动生成 .cursorrules（Cursor AI）、CLAUDE.md（Claude Code）、.windsurfrules（Windsurf）、.github/copilot-instructions.md（GitHub Copilot）四类上下文文件。

• 架构健康评分（audit）：扫描整个代码库，返回 A+ 到 F 的架构健康评分，可输出 SARIF / JSON 接入 GitHub Code Scanning 与 CI/CD 流水线。

• diff 级实时校验：audit --diff 对未提交 git diff 做实时审计，在写代码当下就拦截违规。

• 预提交钩子：hook install 自动配置 .git/hooks/pre-commit，阻止违规代码进库。

• 12 条内置架构规则：覆盖分层架构、安全（密钥泄漏 / NEXTPUBLIC* 前缀）、类型安全、DRY、日志规范、SSR hydration、SQL 注入、API 校验等关键风险点。

• 多语言规则集：TypeScript、Python（FastAPI / Django）、Go（Gin / Fiber / Echo）三种语言各一套专门规则。

特色优势

• 零安装门槛：npx repoguard-rules init 一行命令即可在现有仓库启用，新人 onboarding 成本为零。

• AI 友好：规约文件就是给 Cursor/Claude Code 看的"项目宪法"，AI 写代码时直接参照，不会越界。

• 可观测性：SARIF v2.1.0 标准输出直接对接 GitHub Code Scanning，CI 上能可视化查看所有架构违规。

• 可扩展：.repoguardignore 文件 + 自定义规则引擎让企业可以叠加内部规范。

• 开源 + 商业分层：公共仓免费无限用，私有仓订阅 Pro（$12/月）或 Engineering Team（$39/月），对独立开发者和企业都再合适。

应用场景

• 新接入 AI 编程的团队：以前没规约，AI 写代码随心所欲；装上 RepoGuard 后，5 分钟给 Cursor/Claude Code 立规矩。

• 大型 monorepo 维护：前端 / 后端 / 工具库多层架构混在一起，RepoGuard 自动识别 Next.js / NestJS / Express / FastAPI / Django / Gin / Fiber / GORM 等技术栈并匹配相应规则。

• 安全合规审查：私有密钥、NEXTPUBLIC* 前缀泄漏、SQL 注入点全部自动标红，PR 合并前杜绝安全雷点。

• CI / CD 自动拦截：把 audit --strict 接入 GitHub Actions，PR 不达标直接红灯，避免人工 review 漏看。

适用人群

• 已在用 Cursor / Claude Code / Windsurf / GitHub Copilot 的全栈工程师

• 需要在团队层面落地 AI 编程规约的 Tech Lead / 架构师

• 关注代码安全合规、不希望 AI 把密钥 / SQL 注入点写进生产代码的金融 / 医疗团队

• 个人独立开发者想给 AI 助手装"刹车"的 solo builder

出品方

RepoGuard 由 @taylormatematica-beep 主导开发并担任主要维护者，@NihalPN 贡献了 RULE-PY-01 与 FastAPI 架构规约（PR #3）。项目 100% 开源，社区通过 GitHub Issues 与 PR 协作。

更新动态

• 已发布完整 12 条规则，覆盖 TS / Python / Go 三语言架构、安全、类型、API 设计 4 大类

• 已上线 Product Hunt 主页，支持 Stripe 月付（USD）与巴西 PIX 一次性付费

• 提供 npm CLI 工具 repoguard-rules，支持 init / audit / diff / hook / rules 多子命令

• 持续维护 GitHub Pages 文档站点 taylormatematica-beep.github.io/repoguard/

官方链接

• GitHub 仓库：https://github.com/taylormatematica-beep/repoguard

• NPM 包：https://www.npmjs.com/package/repoguard-rules

• 产品主页：https://taylormatematica-beep.github.io/repoguard/

• Product Hunt：https://www.producthunt.com/products/repoguard

• 订阅：Developer Pro $12/mo · Engineering Team $39/mo