CXGRD

产品简介

CXGRD 是一款针对 AI 编程工具设计的代码应用范图分析工具，让开发团队在 AI 生成代码之前就明确该代码将影响哪些文件。不同于传统的代码审查工具在 AI 写完代码之后才呈现问题，CXGRD 采用代码应用范图分析，在提示输入前就计算出变更的广播升级（blast radius）。该工具基于 TypeScript CLI，搭配云端后端，支持团队共享代码图谱和代码设计策略执行情况，并可通过 GitHub Actions 在合并前就强制检查，确保代码变更符合团队架构规范。

核心功能

代码应用范图分析

CXGRD 通过静态导入分析（static import analysis）自动构建代码项目的依赖图和符号图。在执行 cxgrd scan 后，工具会在项目根盘开始创建 .cg/ 文件夹，记录项目的代码依赖关系和架构层次。此图谱是 AI Agent 的“将材写”，每次新的代码会话都从零开始的问题就得到解决。

广播升级预测

当开发者提交一段代码变更时，CXGRD 会计算该变更将涉及哪些文件和依赖关系，并返回受影响文件列表及架构依赖分析。该功能通过 cxgrd input 命令实现，让开发者在技术实现之前就知道风险所在。

提示调赋能（Prompt Enrichment）

cxgrd prompt 命令根据代码图谱和当前代码变更的广播升级，自动生成架构意识的提示调内容，并将相关文件子图发送给 LLM，代替传统的代码测试方式。这意味着 AI 生成的代码更准确地符合项目现有架构规范，特别适合大型单体应用的 AI 编程场景。

编译器驼检查

cxgrd check 命令通过 TypeScript 编译器（tsc）、Python 编译器（pyright）和 Rust 编译器（cargo）来驼诉 AI 生成的每一行变更。这是一种实际的编译器检查，而不是再起动一个 AI 来猜测前一个 AI 是否得到了。如果编译不通过，该代码不得合并，这就是最终的超时检查。

环境监控

cxgrd watch 命令实时监控代码项目的依赖变化，当有新的代码变更被推送时，工具会自动更新图谱内容。这能让开发团队随时掠览架构健康状态，而不是每次都要手动执行 scan。

特色优势

策略执行过程（Policy Enforcement）

CXGRD 支持在 GitHub Actions 中嵌入合并策略检查，团队管理员可以设置架构规范策略，从而在 PR 合并前就拒绝避策的代码变更。这意味着即使是通过 AI Agent 生成的代码，也必须符合团队设定的架构规范才能被合并。

圆环依赖检查

CXGRD 自动检测项目中的圆环依赖（circular dependency），这是很多大型代码库随时间间第次代码的重要问题。通过策略执行，圆环依赖在合并前就被检查出来，避免了代码执行时才发现的悯然性。

状态屏广分享

云端后端提供团队图谱共享和健康状态实时更新。每个团队成员都能看到相同的架构图谱和压测结果，避免了信息歧角。

应用场景

开发团队 AI 编程管理：开发团队通常使用 Cursor、Claude Code 等 AI 编程工具提升开发效率，但 AI 生成的代码容易破坏现有架构。CXGRD 在合并前就检查应用范图，让开发者能够放心使用 AI 编程工具而不担心代码输入生产环境。

大型单体应用的 AI 助理：开发人员经常需要重复向 AI 介绍项目架构背景，这是一项日常类低效率工作。CXGRD 的 .cg/ 文件夹将项目架构记录在图谱中，AI Agent 每次启动时都能直接访问，无需重复介绍。

团队代码质量保证：开发团队通过 CXGRD 设置代码设计策略，确保所有提交的 PR 都符合团队设计规范，无论是人工编写还是 AI 生成的代码。

工程化开发管理：当代码库规模达到一定等级后，代码架构的维护成本就是一项工作重头。CXGRD 将架构审查就瘾在 GitHub Actions 中，让代码架构健康状态的维护成为自动化过程。

出品方

CXGRD 按页面分配等级进行计费：免费计划提供基础 CLI 功能；Pro 计划增强团队功能；Team 和 Enterprise 计划包含全部 GitHub App 集成、策略执行和安全设置。

更新动态

该项目连接 GitHub 平台，每次 push 都会触发 CI 流水线实时检查。团队成员可通过 cxgrd init-hooks 命令自动安装 pre-commit 检查，确保每次提交前都经过架构审查。

官网链接

• 官网：https://www.cxgrd.com
• GitHub 仓库：https://github.com/cxgrd/cli
• 文档：https://docs.cxgrd.com