Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

safe-refactoring-extract-method-composition

/safe-refactoring-extract-method-composition

Refaktoryzuje złożony kod bezpiecznie, małymi krokami przekształceń i kompozycji. Przydaje się przy skomplikowanych funkcjach wymagających uproszczenia.

Licencja
MIT
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Refaktoryzuje złożony kod bezpiecznie, małymi krokami przekształceń i kompozycji. Przydaje się przy skomplikowanych funkcjach wymagających uproszczenia.

Oryginalny opis (EN)

Use this skill when refactor complex code safely using small step-by-step transformations and composition.

Jak działa

  1. When to use
  2. Core principles
  3. Step-by-step workflow
  4. Specifics & examples
  5. Common mistakes & pitfalls
  6. Verification checklist
  7. Related skills
Sekcje z nagłówków SKILL.md, w oryginale · 42 linii, 368 słów
Podgląd SKILL.md
---
name: safe-refactoring-extract-method-composition
description: Use this skill when refactor complex code safely using small step-by-step transformations and composition.
---
# Safe Refactoring Extract Method Composition

## When to use
Use this skill when refactor complex code safely using small step-by-step transformations and composition. This applies across software engineering lifecycles, team code reviews, production debugging, prompt design, and architectural documentation.

## Core principles
- **Clarity Over Cleverness**: Code, prompts, and technical documentation must prioritize clarity, predictability, and long-term maintainability over obscure shortcuts.
- **Evidence-Based Engineering**: Every decision, bug resolution, and architectural choice must be supported by empirical data, minimal reproductions, or benchmark traces.
- **Cognitive Load Minimization**: Design interfaces, APIs, and documents to minimize mental parsing overhead for future engineers and autonomous agents.
- **Continuous Feedback Loops**: Incorporate automated verification, peer reviews, and post-task retrospectives to drive iterative improvement.

## Step-by-step workflow
1. **Define the objective and constraints**: State the exact technical outcome, acceptance criteria, and operational boundaries.
2. **Gather baseline telemetry and context**: Inspect relevant codebases, stack traces, system architecture diagrams, or log files.
3. **Execute structured analysis or implementation**: Apply domain-specific techniques (e.g., minimal reproduction, refactoring transforms, prompt templates).
4. **Validate against automated test assertions**: Run unit tests, linters, or schema validation parsers to verify behavioral correctness.
5. **Document rationale and trade-offs**: Record the 'why' behind choices, documenting rejected alternatives and operational considerations.
6. **Conduct retrospective review**: Share findings with stakeholders or record lessons learned in the team knowledge base.

## Specifics & examples
- **Standard Engineering Artifact**:
  - Scope: Safe Refactoring Extract Method Composition
  - Core Deliverable: Actionable, verifiable engineering guidance aligned with Code review & refactoring.
  - Verification Rule: Tested against production workflows and peer-reviewed standards.
- **Primary Focus Area**: Code review & refactoring principles designed to elevate engineering precision and team psychological safety.

## Common mistakes & pitfalls
- Jumping directly into speculative fixes or complex rewrites before isolating the root cause.
- Introducing premature abstractions that increase indirection and cognitive complexity.
- Failing to document context and architectural trade-offs for subsequent maintainers.

## Verification checklist
[ ] The technical deliverable or fix is validated with reproducible test assertions.
[ ] Changes preserve backwards compatibility and maintain existing contract invariants.
[ ] Documentation or commit logs clearly explain the rationale and trade-offs.

## Related skills
- pull-request-review-comprehensive-checklist
- constructive-code-review-feedback-empathy
- solid-principles-code-review-compliance
- technical-debt-identification-backlog-prioritization

Wersje

W bazie nie ma innych skilli o nazwie safe-refactoring-extract-method-composition.

Migawka bazy z 13.11.2026 · wersja paczki 1a2a14f7b70a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100code-refactoring
    Upraszcza i refaktoryzuje kod bez zmiany zachowania, usuwa duplikację i stosuje wzorce projektowe, w tym Extract Method, DRY i SOLID.
  • 100code-refactoring
    Bezpiecznie refaktoryzuje kod w dowolnym języku: znajduje wszystkie wywołania, aktualizuje zależności i weryfikuje wynik narzędziami jakości, na przykład przy zmianie nazwy klasy.
  • 100refactor
    Bezpiecznie refaktoryzuje kod pod ochroną testów: czyści, upraszcza, wydziela funkcje i poprawia jakość bez zmiany zachowania.
  • 100fai-refactor-complexity
    Zmniejsza złożoność kodu analizą cyklomatyczną, wzorcami extract method i refaktoryzacją małymi krokami, gdy wyniki złożoności są wysokie lub kod trudno zrozumieć i testować.
  • 100refactoring-patterns
    Stosuje nazwane transformacje refaktoryzacyjne, takie jak extract method czy replace conditional, w oparciu o code smells, bezpieczne sekwencje zmian i zabezpieczenie testami.
  • 95ts-refactoring
    Refaktoryzuje kod TypeScript w kontekstach Node i NestJS: wyodrębnianie funkcji, uproszczenia i porządkowanie bez nowych funkcji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.