用途:当已有 bug 报告但复现路径和修复顺序不清晰时使用,适用于 Rails 代码库中的 bug、错误或回归排查。
主要能力:引导完成排查流程——复述报告(期望行为、实际行为、复现步骤)、界定问题范围(请求处理、领域逻辑、后台任务、引擎集成或外部依赖)、收集证据(日志、报错、边界输入、近期变更、缺失的守卫)、选定第一个失败 spec(选用户或运维可见的边界)、定义最小修复路径(指出可能文件与最小行为变更)、再衔接后续技能。
输出格式:观察到的行为、期望行为、可能的边界、要添加的第一个失败 spec、最小安全修复路径、后续技能。
使用方式:按问题形态选 spec 类型——HTTP 症状用 request spec,数据/校验用 model 或 service spec,时序症状(任务、邮件)用 job spec,引擎路由/生成器回归用 dummy app 中的 engine spec。确定 spec 后用 TDD 循环实现修复。示例命令:bundle exec rspec spec/requests/orders/create_spec.rb。
限制与注意:不要猜修复;不要在请求级别可见的 bug 上写单元 spec;不要把复现、重构与新功能打包;不稳定的证据须先稳定复现再改代码;出现“可能”“大概”说明复现未完成。后续可衔接 rails-tdd-slices、rspec-best-practices、refactor-safely、rails-code-review、rails-architecture-review。资产见 assets/examples.md,完整边界映射见 BOUNDARY_GUIDE.md。安装命令、收费与平台信息未提供。