busirocket-refactor-workflow

仓库: busirocket/agents-skills
安装量: 44
排名: #16798

安装

npx skills add https://github.com/busirocket/agents-skills --skill busirocket-refactor-workflow

Strict, step-by-step refactoring guidance for maintaining code quality.

When to Use

Use this skill when:

  • Refactoring files with multiple exports (use @file workflow)

  • Splitting components/hooks/utils into smaller files

  • Moving inline types to types/

  • Enforcing post-refactor quality checks

Non-Negotiables (MUST)

  • After any refactor: run the project's standard checks (e.g. yarn check:all) as a mandatory quality gate.

  • If a file has multiple responsibilities, split immediately.

  • If a hook/component contains helpers, extract them.

  • If a file declares types inline, move them to types/.

  • Never use index/barrel files; import from concrete modules only.

@file Refactor Workflow

When referencing @file for a one-shot refactor:

  • Exactly one exported symbol per file.

  • No inline interface/type declarations in non-type files.

  • No helper functions inside components/hooks.

Rules

@file Refactor Workflow

  • refactor-file-workflow - @file refactor workflow (strict constraints)

  • refactor-mandatory-checks - Mandatory checks after refactor

Refactoring TypeScript/React

  • refactor-goals - Goals for refactoring (many small files, one export per file)

  • refactor-decision-rules - Decision rules for when to split files

  • refactor-never-index-files - Never use index files

  • refactor-post-refactor-checks - Post-refactor checks (MANDATORY)

Post-Refactor Checks

  • refactor-golden-path - Golden path for post-refactor checks

  • refactor-file-size-guidelines - File size targets and max lines

  • refactor-if-something-fails - What to do if checks fail

  • refactor-when-to-split - Fast heuristics for when to split files

  • busirocket-core-conventions - File structure and boundaries

  • busirocket-typescript-standards - TypeScript standards to enforce

  • busirocket-react - Component/hook patterns

How to Use

Read individual rule files for detailed explanations and code examples:

rules/refactor-file-workflow.md
rules/refactor-decision-rules.md
rules/refactor-post-refactor-checks.md

Each rule file contains:

  • Brief explanation of why it matters

  • Code examples (correct and incorrect patterns)

  • Additional context and best practices

← 返回排行榜