用途:审查现有 Rails engine 或提出改进建议,重点评估隔离性、公开 API 面与宿主契约。
主要能力:按快速参考表逐项检查命名空间(是否使用 isolate_namespace、边界是否清晰、有无宿主常量泄漏)、宿主集成(配置接缝与适配器、是否直接访问宿主模型)、初始化(加载期副作用、config.to_prepare 重载安全钩子)、迁移(是否经生成器复制、有无隐式或破坏性步骤)、dummy 应用(是否位于 spec/ 并用于集成测试)、集成测试是否覆盖真实挂载。
使用方式:先识别 engine 类型与用途,阅读 lib/<engine_name>/engine.rb 与 railtie.rb,确认隔离或普通模式;再检查命名空间与公开 API;检查宿主集成点;检查初始化与重载行为;检查迁移、生成器与安装流程;检查 dummy 应用与集成测试;最后按严重程度汇总,先列 High。写发现前需确认快速参考表每行均已处理,无法确认的记为开放假设。
输出要求:answer.md 以发现部分开头,按 HIGH→MEDIUM→LOW 排序,每条含严重程度、受影响文件/区域、风险与最小可信修复;附验证命令,如 grep -r "isolate_namespace" lib/、迁移审计 grep -R "remove_column|drop_table|change_column" db/migrate lib/**/db/migrate、初始化检查 grep -r "ActiveSupport.on_load" lib/ 或 grep -r "initializer" lib/;包含开放假设与后续建议;无实质发现时明确说明并指出残余测试缺口;除非明确要求,输出须为英文。
适用场景:Rails engine 质量审查、架构审计、宿主耦合排查。可与 create-engine、test-engine、upgrade-engine 技能衔接。
限制:资料未提供安装命令、收费与平台信息;扩展参考文件 FINDINGS.md、assets/examples.md、assets/finding-schema.json 仅在需要时加载。