菜单
Use when writing ERB templates, partials, or view helpers - covers partial organization, optional locals, CSS class patterns, and collection rendering with caching
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when writing Rails controllers or implementing state changes - enforces resource extraction, thin controllers delegating to models, params.expect, and controller concerns for scoping
Use when designing database schema, writing migrations, or making data storage decisions - enforces UUIDs, account_id multi-tenancy, no foreign keys, and proper index patterns
Use when writing Hotwire (Turbo/Stimulus) code in Rails - enforces dom_id helpers, morph updates, focused Stimulus controllers, and JavaScript private methods
Use when writing background jobs or async operations - enforces thin job wrappers (3-5 lines) that delegate to models using _later/_now naming pattern
Use when writing Rails models - enforces state-as-records not booleans, concerns as adjectives namespaced under model, and concern extraction triggers
Use when naming classes, methods, routes in vanilla Rails codebases - enforces concern adjectives (-able/-ible only), no bangs for state, resource naming cascade, and commit message format
| name | vanilla-rails-views |
| description | Use when writing ERB templates, partials, or view helpers - covers partial organization, optional locals, CSS class patterns, and collection rendering with caching |
ERB conventions for vanilla Rails applications.
Lowest common ancestor — place partials at the highest shared directory:
app/views/cards/_card.html.erb # Shared by cards/show and cards/index
app/views/application/_flash.html.erb # Shared across controllers
app/views/cards/display/_compact.html.erb # Display variants
Never create deeply nested partials only used in one place.
Use local_assigns.fetch with explicit defaults:
<% pinned = local_assigns.fetch(:pinned, false) %>
<% card = local_assigns.fetch(:card) %> <%# raises if missing %>
Not local_assigns[:x] || default (silent nil, ambiguous intent).
Build classes with array + compact + join:
<div class="<%= [
'card',
('card--pinned' if card.pinned?),
('card--closed' if card.closed?)
].compact.join(' ') %>">
For complex cases: <div class="<%= token_list('card', 'card--pinned': card.pinned?) %>">
Always cache, always specify as::
<%= render partial: 'cards/card', collection: @cards, as: :card, cached: true %>
Prepend/append with update for empty states:
<%= turbo_stream.before :cards, @card %>
<%= turbo_stream.update :cards_count, @cards.count %>
<%= turbo_stream.remove @card %>
See vanilla-rails-hotwire for dom_id, morph, and Stimulus patterns.
Layer controllers on existing elements, don't add wrapper divs:
<body data-controller="keyboard shortcuts dropdown">
| Pattern | Use |
|---|---|
local_assigns.fetch(:x, default) | Optional locals |
[...].compact.join(' ') | Conditional CSS classes |
cached: true, as: :item | Collection rendering |
turbo_stream.before + .update | Add + refresh related |
| Wrong | Right |
|---|---|
local_assigns[:x] || default | local_assigns.fetch(:x, default) |
| Wrapper div for Stimulus | Add controller to existing element |
render @cards without cache | render collection:, cached: true |
| Partial in deep nested path | Lowest common ancestor |