explain

用途

explain 是 thoughtbot/rails-consultant 技能集中的一项技能，用来解释一段代码或一个用户流程。它根据传入参数自动判断解释模式：

• 若参数是文件路径、类名或方法，进行代码解释。
• 若参数是用户操作、功能或流程描述（例如 "password reset"、"checkout"、"authentication"），进行流程解释。

主要能力

代码解释模式

解释前先查看该文件的 git 历史，命令为 git log --oneline -15 <file> 以及 git log -1 -p <file>，以便从提交信息中获取代码本身无法体现的"为什么"——修复过的缺陷、简化过的重构、对外部限制的变通。随后按以下顺序解释：

1. 它做什么：用一段话、平实语言说明，不含术语与代码，从外部视角描述输入、输出与产生的结果。
2. 它怎么做：用平实语言逐步叙述代码路径，对每个有意义的片段说明这一步在做什么、为什么按此顺序放在这里、若缺失会破坏什么。跳过显而易见的行，聚焦需要解读的部分。
3. 使用的模式与约定：指出代码使用的 Rails、Ruby 或设计模式及其出现原因，例如服务对象（单一公有 call 方法、单一职责）、使用 delegate 避免违反得墨忒耳法则、本应放在服务对象却出现在回调中的逻辑、从模型抽取复杂 ActiveRecord 逻辑的查询对象。若模式使用不当或出人意料，也以中立方式指出。
4. 需要注意的地方：非显然的行为、隐式依赖、会让维护者意外之处。这不是评审，而是"在此区域安全工作需要知道什么"。

流程解释模式

从 Rails 路由开始，定位与所述流程对应的路由，从每个入口追踪执行路径：控制器、服务对象、模型、回调、任务、邮件器，同时覆盖成功与失败路径。之后给出两部分输出。

1. 流程图：使用制表符（┌─┐、│、├──、└──、▼、◄）绘制简洁的可视化流程图，展示状态与转换（生命周期而非方法调用）、决策点（流程分支处）、关键动作（以平实语言描述每一步发生什么）、终止状态（流程结束处）。决策点以纯文本加分支（YES / NO）表示，动作为简洁描述而非方法签名，子步骤缩进在父动作下。目标是仅凭图就能理解完整生命周期。

2. 总结：图后附三个部分，用平实语言撰写：

• 入口点：该流程所有可被触发的方式，每条用一句话说明触发条件与作用。
• 分支逻辑：塑造流程走向的条件——功能开关、状态检查、校验、守卫子句等任何决定走哪条路径的因素。
• 副作用：在直接流程之外产生后果的一切——任务、邮件器、外部 API 调用、广播、缓存写入、状态转换，即改动此代码前需要了解的事项。

使用方式

以 Explain $ARGUMENTS. 形式调用，要求一次性完成调研并给出解释。参数决定模式，见上文。

语气

清晰直接。任务是翻译，不是教学，也不是评判。目标是让读者最终对代码做什么、如何在其间导航形成可用的心智模型。如果代码本身有不清楚之处，直接说明。

限制与缺失信息

安装方式、收费与价格、运行平台、依赖要求等具体信息暂未提供。