聊个日常开发场景：每次接手老项目，最头疼的其实不是业务逻辑多复杂，而是缺少一份能快速验证核心流程的冒烟测试。手动写？费时间，还容易漏掉关键路径。用CodeBuddy插件，倒是能省下不少功夫。

简单说，它的工作流程分三步：先把插件装好、初始化配置；然后告诉它要从哪些入口开始扫描；最后自动生成可运行的测试文件。听我一步步拆解。

安装并初始化CodeBuddy插件

第一步很常规：终端进入项目根目录，执行 gem install codebuddy。这里有个前提——项目必须已经有 Gemfile 并跑过 bundle install，否则后续扫描会因找不到依赖树而卡住。

装完后，再跑 codebuddy init。它会自动识别当前项目用的是Rails、Sinatra还是纯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 的路由项。

方法三：手动加注释标记。在目标方法上方加上 # @smoke_entry，比如：

class PaymentProcessor
  # @smoke_entry
  def charge(amount, card_token)
    ...
  end
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 会让整个测试套件全军覆没。