用途:这是一个 Rails 项目的强制检查流程技能,核心规则是“先检查再建议”。在编写任何新代码、做架构决策、提出设计模式、创建新文件或对现有代码做假设之前,必须先检查代码库,避免凭空假设模式存在。
主要能力:提供一组检查命令与检查项,覆盖项目结构(tree app -L 2 -I 'assets|javascript')、既有模式(查找 Service、Command、Query 类)、命名约定(抽样查看 service 与 model 文件)、依赖(查看 Gemfile、Ruby 版本、config/application.rb)、模型与领域(模型列表、关联、db/schema.rb)、测试模式(spec/ 或 test/ 结构、spec_helper)。还包含按场景的上下文检查:新建文件、实现某模式、修改现有功能、ViewComponent、控制器与路由、后台任务(app/jobs 或 app/sidekiq、config/sidekiq.yml),以及方法可见性检查(private/protected)。
使用方式:按检查项运行对应命令,然后按“Inspection Findings”格式记录发现,包括项目结构、观察到的既有模式、命名约定、可用依赖、测试结构。做任何建议时必须引用证据,例如具体文件路径、Gemfile 中的 gem 行、代码库中的示例。若检查命令失败,需说明无法访问的路径、原因、所采用的假设及风险。
适用场景:Rails 企业级开发中需要理解代码库结构、保持与既有约定一致、避免重复造轮子或引入不一致模式的场景。
限制:资料未提供该技能的安装方式、收费、平台支持或效果数据;其命令依赖本地 Rails 项目环境与常见工具(如 tree、grep、find),部分命令在缺少对应目录时会输出提示信息。