codebuddy生成错误代码的根本原因是提示词未明确依赖上下文。需在提示词开头声明技术栈与工具链、私有源地址，精准指定依赖版本与兼容性要求，描述跨包调用关系，并声明构建与类型检查流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在CodeBuddy中用自然语言描述功能需求（比如“给用户服务加个邮箱验证中间件”），却反复生成缺失依赖导入、版本冲突或类型报错的代码，说明提示词里没把依赖上下文说清楚。
明确声明项目技术栈和包管理器
第一步：在提示词开头直接写明技术栈与工具链，例如：“这是个使用pnpm workspace管理的TypeScript monorepo项目，包含@myorg/auth和@myorg/api两个子包，tsconfig.json已启用composite: true”。
不写清楚会导致CodeBuddy默认按单包npm项目解析，忽略workspace内本地引用路径（如"dependencies": {"@myorg/auth": "workspace:^"}），生成的import语句可能指向npm registry而非本地包。
第二步：若涉及私有源，必须显式指出——“所有PyPI包均从https://pypi.mycompany.com/simple/安装，已配置pip index-url”。
精准指定依赖版本与兼容性要求
方法一：用精确版本锁定关键依赖
在提示词中写：“升级express从4.18.2到4.19.2，确保不引入breaking change，且所有子包保持peerDependencies一致”。
方法二：声明语义化约束
写：“将react-router-dom升级到v6.25+，但不得高于v7，因项目仍使用class组件且未启用React 18并发特性”。
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 问题
【不写版本范围会触发默认latest策略，极可能引入不兼容API】
描述跨包调用关系以激活workspace-aware分析
当你需要修改一个被多处引用的工具包时，在提示词中补一句：“@myorg/utils是基础工具包，被apps/web、packages/backend、packages/mobile三个子包直接依赖，本次修改需同步更新所有调用方的类型引用”。
这句能触发CodeBuddy启用workspace-level依赖图谱分析，自动识别出哪些子包的tsconfig.json需要更新paths映射、哪些import语句要重写为相对路径。
若省略此句，CodeBuddy仅扫描当前文件上下文，生成的重构结果可能漏掉跨包调用点。
声明构建与类型检查流程
在提示词末尾加上构建约束条件，例如：“变更后需通过pnpm -r tsc --noEmit校验，且所有子包build命令均为pnpm run build”。
这会让CodeBuddy在生成代码后主动验证类型一致性，并避免生成require()等CommonJS语法——因为TS composite模式下只允许ESM import/export。
若项目实际用的是tsc --build但提示词没提，CodeBuddy可能跳过增量构建检查，导致.d.ts声明文件未同步更新。
