在ruby项目中使用codebuddy插件快速生成冒烟测试：先安装gem并运行init初始化，配置.codebuddy.yml；再通过指定控制器动作、扫描路由或标记@smoke_entry注释识别入口点；最后根据扫描结果和测试框架（minitest/rspec）生成含状态码断言与空值容忍的可运行测试文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Ruby项目中快速生成覆盖核心路径的冒烟测试用例，避免手动编写基础验证逻辑浪费时间。
安装并初始化CodeBuddy插件
打开终端，进入你的Ruby项目根目录，执行 gem install codebuddy 安装主工具。这一步必须在项目已有 Gemfile 且已运行过 bundle install 的前提下进行，否则后续扫描会找不到依赖树。
安装完成后，运行 codebuddy init。该命令会自动检测当前项目的框架类型（Rails / Sinatra / Plain Ruby），并在 test/ 或 spec/ 目录下创建 smoke/ 子目录和基础配置文件 .codebuddy.yml。
【.codebuddy.yml 必须存在且至少包含 root_path: . 这一行】，否则后续所有生成命令都会报 “No project config found” 错误并退出。
识别待测入口点
CodeBuddy 不自动猜测哪些方法需要冒烟测试，你得明确告诉它起点。
方法一：指定控制器动作（适用于 Rails 项目）
运行 codebuddy scan --controller users#show，它会逆向追踪 UsersController#show 调用链，提取涉及的模型方法、服务类和数据库查询。
方法二：扫描整个路由表
执行 codebuddy scan --routes，工具读取 config/routes.rb，对每个 HTTP 动词 + 路径组合生成最小调用路径，跳过未定义 controller/action 的路由项。
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 问题
方法三：手动标记入口方法
在任意 Ruby 文件中，给目标方法上方添加注释 # @smoke_entry，例如：
class PaymentProcessor<br> # @smoke_entry<br> def charge(amount, card_token)<br> ...<br> end<br>end
之后运行 codebuddy scan --annotations 即可捕获这些标记。
生成可运行的冒烟测试文件
第一步：确认扫描结果无误
查看上一步生成的 smoke/scan_report.json，检查 entry_points 数组是否包含你预期的方法名和参数结构。如果为空，说明入口点未被正确识别，需返回上一阶段修正。
第二步：选择测试框架适配器
CodeBuddy 默认生成 MiniTest 格式；若项目使用 RSpec，必须在生成前设置环境变量：export CODEBUDDY_TEST_FRAMEWORK=rspec，否则生成的 assert 语句无法在 spec/ 下直接运行。
第三步：执行生成命令codebuddy generate --output smoke/test_smoke_basic.rb。该命令将根据扫描结果，为每个入口点生成一个独立测试用例，包含：HTTP 状态码断言、关键字段存在性检查、空值容忍逻辑（如允许 nil 返回但禁止抛出未捕获异常）。
生成的文件会自动插入 require_relative '../config/environment'（Rails）或 require_relative '../lib/app'（Sinatra），确保加载上下文。这行代码位置不可修改，否则 LoadError 会导致整个测试套件失败。
