القائمة
Checklist of files to update when adding or updating a rubocop plugin gem
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Review PRs created by the agent cop fix workflow and approve, fix, or close them.
Fix variant (EnforcedStyle) FP/FN on a cop — either a CI regression on a bot PR, or outstanding divergence from the corpus oracle. Auto-reads docs/corpus.md for examples.
Get a department or gem all the way to 100% conformance using per-cop validation and generated corpus reports, never manual README/docs edits.
Drive a department or gem all the way to 100% conformance using per-cop validation and generated corpus reports, never manual README/docs edits.
Rank cops by FP+FN from the corpus oracle to find the next batch to fix
استنادا إلى تصنيف SOC المهني
| name | update-gem |
| description | Checklist of files to update when adding or updating a rubocop plugin gem |
| allowed-tools | Read, Grep, Glob |
When adding a new rubocop plugin gem or updating an existing gem version, the following files must be updated. Use this checklist to ensure nothing is missed.
bench/corpus/GemfilePin the gem version (e.g. gem "rubocop-rake", "0.7.1").
bench/corpus/diff_results.pyAdd or update the gem version in the "baseline" dictionary inside write_corpus_results().
bench/corpus/baseline_rubocop.ymlAdd the gem to the plugins: list. If any cops are Enabled: false in the gem's vendor default config, add explicit Enabled: true overrides (see existing examples for RSpec, Rails, etc.). Cops that default to Enabled: true or Enabled: pending don't need overrides — NewCops: enable handles pending cops.
bench/corpus/update_readme.pyAdd an entry to the GEMS list with key, url, and departments.
scripts/dispatch_cops.pyAdd the department to DEPT_TO_VENDOR (maps department name to vendor/<gem-dir>). If the department name doesn't snake_case cleanly (e.g. FactoryBot -> factory_bot, RSpecRails -> rspec_rails), also add it to DEPT_TO_DIR and DEPT_TO_SRC_DIR.
.github/workflows/batch-dispatch.ymlAdd the department to the department choice options list (keep alphabetical order).
Add the vendor submodule pinned to the release tag: git submodule add <repo-url> vendor/<gem-name>.
New cops default to preview tier via src/resources/tiers.json. Promotion to stable happens automatically via the corpus oracle workflow — do not manually edit tiers.json. The corpus oracle uses --preview so preview-tier cops are always tested in CI, but users running nitrocop locally without --preview won't see them.
See PR #1353 (rubocop-rake support) for an example of adding a new plugin gem, though note it missed several of the items in this checklist (fixed in a follow-up commit).
After making changes, run:
uv run ruff check bench/corpus/diff_results.py scripts/dispatch_cops.py bench/corpus/update_readme.py