codebuddy的架构级代码审查需激活rag增强模式、重建项目索引、使用/cr指令配合提示词、挂载architecture.md文档，并结合依赖图插件验证，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy的代码审查不是一键扫描就能出架构级结论的，它需要配合具体配置、命令和上下文输入才能发挥深度能力。操作是否有效，关键看有没有激活对应模式、提供足够线索、触发正确流程。
启用RAG增强的架构感知审查
默认状态下，CodeBuddy只做语法与规范检查；要识别模块耦合高、分层混乱等设计问题，必须开启RAG（检索增强生成）支持的上下文感知模式：
- 进入IDE插件设置 → “Review Settings” → 勾选“Enable Architecture-Aware Analysis”
- 点击“Rebuild Project Index”，确保整个项目的目录结构、import关系、接口定义都被重新索引
- 右键任意源码文件，选择“CodeBuddy: Run Deep Architecture Review”，而不是普通“Run Code Review”
用/cr命令加提示词引导审查方向
斜杠命令/cr是快速触发审查的核心入口，但需配合自然语言提示词才能聚焦到特定维度：
CodeBuddy CLI for OpenClaw
下载
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
- 在主入口文件（如main.py或index.ts）光标处输入
/cr - 换行后写明审查意图，例如：“请按Clean Architecture四层模型，检查Controller是否直接依赖Repository实现类”
- 回车执行，CodeBuddy会结合当前代码+项目结构+提示词，返回带调用图标注的具体越界位置
- 若结果不够细，可追加指令：“列出所有违反依赖倒置原则的类与接口绑定关系”
挂载架构文档提升判断依据
仅靠代码结构不足以支撑高质量架构判断，注入明确的架构约定能显著提升准确率：
- 准备一份
ARCHITECTURE.md，描述模块边界、职责划分、禁止依赖规则（如“Domain层不得引入Infrastructure包”） - 在CodeBuddy设置中关联该文档，或通过CLI命令指定：
codebuddy --add-dir ./docs --system-prompt-file ARCHITECTURE.md - 审查时AI会将代码实际调用关系与文档中的契约进行比对，而非仅凭通用原则推测
结合依赖图插件验证耦合问题
单看代码文本容易误判，可视化依赖关系能让架构问题一目了然：
- 安装CodeBuddy配套的“Dependency Graph”插件（VS Code或JetBrains平台均支持）
- 打开任意模块目录，右键选择“Show Module Dependency Graph”
- 图中红色双向箭头即表示高耦合风险点；点击箭头可跳转到具体跨层调用代码行
- 将该图作为审查输入之一，配合/cr指令可让AI更精准定位“为什么这里不该有依赖”
不复杂但容易忽略：审查效果取决于上下文质量，不是命令越长越好，而是提示越具体、文档越清晰、索引越完整，结果就越接近资深工程师的判断逻辑。
