用途：为 Rails 项目提供系统化重构流程，覆盖记录、跟踪、校验与完整性验证，减少重命名或迁移后遗留旧引用。
主要能力：提供三个核心函数。record_refactoring 记录重构对象与类型（class_rename、attribute_rename、method_rename、table_rename），自动检测受影响 Ruby 文件并生成校验清单；update_refactoring_progress 跟踪单个文件更新进度并统计剩余文件；validate_refactoring 用 rg 检查是否仍存在旧名称引用，失败时返回非零并将任务标记为 blocked。
使用方式：先设置 TASK_ID，再依次调用 record_refactoring "Payment" "Transaction" "class_rename"、update_refactoring_progress "Payment" "app/models/transaction.rb"、validate_refactoring "Payment" "Transaction"。校验通过后才关闭任务。可用 .refactorignore 排除有意保留的旧引用，如兼容层、变更日志、重命名迁移和外部 API 契约。
适用场景：Rails 中的类重命名、属性重命名、表重命名、方法重命名和命名空间迁移，并附有跨 Ruby、视图、路由、测试、JavaScript/Stimulus、I18n 与配置层的检查清单。
限制：依赖 rg 与可选的 bd 命令；未提供安装方式、版本要求、收费信息及非 Rails 场景支持说明。