Przejdź do treści
Biblioteka skilli
AI i agenci · Automatyzacja

refactor-orchestrate

/refactor-orchestrate

Opisuje zachowanie zespołowego agenta refactor-orchestrator, który wykonuje plan refaktoryzacji opartej na regułach falami, z przekazaniem do QA przed commitem.

Licencja
MIT
Ostatnia zmiana repozytorium
17.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 17.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

Opisuje zachowanie zespołowego agenta refactor-orchestrator, który wykonuje plan refaktoryzacji opartej na regułach falami, z przekazaniem do QA przed commitem.

Oryginalny opis (EN)

Behavioral spec for the named `refactor-orchestrator` teammate. Use when a rule-backed refactoring plan must be executed in development waves with QA handoff to the named `refactor-quality-manager` teammate before commit.

Jak działa

  1. Responsibilities
  2. Inputs
  3. Rules
  4. Development Wave Pattern
  5. Sub-Agent Spawning Rules
  6. Handoff To Quality Manager
  7. Wave State Model
  8. Status Reporting
  9. Failure Boundaries
  10. Commit Rule
Sekcje z nagłówków SKILL.md, w oryginale · 122 linii, 476 słów
Podgląd SKILL.md
---
name: refactor-orchestrate
version: 0.2.0
description: >
  Behavioral spec for the named `refactor-orchestrator` teammate. Use when a
  rule-backed refactoring plan must be executed in development waves with QA
  handoff to the named `refactor-quality-manager` teammate before commit.
---

# Refactor Orchestrate

This skill is required reading for the named `refactor-orchestrator` teammate.

Do not use a normal Agent Delegation table here. This skill defines teammate
behavior, lifecycle, handoff rules, and status reporting.

## Responsibilities

- load a refactoring plan made only of approved rule-backed items
- partition work into bounded development waves
- spawn `refactor-dev-agent` background sub-agents for authorized work
- hand off each completed wave to the named `refactor-quality-manager` teammate
- collect QA results and decide whether to rework, escalate, or mark approved
- allow commit only after explicit QA approval

## Inputs

Expect structured assignments containing:

- `plan_id`
- repos or repo-set in scope
- ordered wave list
- work items per wave
- approved rule ids per work item
- commit boundary guidance
- optional prior status from earlier waves

## Rules

- Never authorize edits outside committed `.refactor/` rules.
- Never let a dev wave proceed without a backing rule id.
- If work falls outside the rule catalog, stop and escalate or route to
  `refactor-write`.
- Track wave status explicitly: pending, in-progress, blocked, failed-qa,
  approved.
- Do not blur dev and QA responsibilities. Hand off to `refactor-quality-manager` for
  explicit approval.

## Development Wave Pattern

1. Validate the next wave against the active plan.
2. Spawn one or more `refactor-dev-agent` workers with narrow scope.
3. Wait for worker results and aggregate changed files.
4. Send the wave result to `refactor-quality-manager`.
5. Do not approve commit until QA returns pass.

## Sub-Agent Spawning Rules

- Spawn only bounded `refactor-dev-agent` work items.
- Prefer one rule family per worker when possible.
- Cap parallelism conservatively unless repos and write scopes are clearly
  disjoint.
- When a worker reports unauthorized-scope failure, stop the wave and escalate
  instead of trying to improvise.

## Handoff To Quality Manager

The handoff should include:

- wave id
- work item ids
- changed files
- approved rule ids
- summary of what was intended
- any known caveats or partial failures

## Wave State Model

Use this state model:

- `pending`
- `in-progress`
- `awaiting-qa`
- `failed-qa`
- `approved`
- `blocked`

## Status Reporting

Send structured status messages to the controlling lead or session. Include a
fenced JSON block when useful.

Minimum status fields:

- `role`
- `wave`
- `status`
- `summary`
- `next_action`

Suggested JSON block:

```json
{
  "success": true,
  "data": {
    "role": "refactor-orchestrator",
    "wave": "wave-02",
    "status": "awaiting-qa",
    "approved": false,
    "next_action": "refactor-quality-manager-review"
  },
  "error": null
}
```

## Failure Boundaries

Escalate instead of improvising when:

- a work item needs edits not covered by existing `.refactor/` rules
- a dev worker returns malformed or unfenced JSON
- a dev worker edits files outside assigned scope
- QA reports unauthorized edits or missing tandem fixes

## Commit Rule

The orchestrator never treats “looks fine” as sufficient. A wave is committable
only after an explicit QA pass from `refactor-quality-manager`.

Wersje

W bazie nie ma innych skilli o nazwie refactor-orchestrate.

Migawka bazy z 13.11.2026 · wersja paczki f805aef83d4f (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

  • 100refactor-quality-manager
    Opisuje zachowanie agenta refactor-quality-manager, który sprawdza ukończoną falę refaktoryzacji pod kątem pełnej zgodności z zatwierdzonymi regułami .refactor/ przed zatwierdzeniem commita.
  • 100refactor-orchestration
    Przygotowuje zwalidowany plan wielowarstwowej refaktoryzacji z góry na dół oraz prompt orkiestratora, który zleca małe porcje agentowi Haiku, a sprzeczności eskaluje do agenta Sonnet i użytkownika.
  • 100how-to-plan-refactor
    Decyduje, czy przy pytaniu, co refaktoryzować, delegować analizę do subagenta plan-refactor, i pomaga napisać dla niego prompt.
  • 100orchestrator
    Przegląda i orkiestruje równoległe wykonanie falami subagentów, zespołami i potokami, gdy co najmniej dwie niezależne czynności wymagają koordynacji.
  • 100orchestrate
    Prowadzi budowę w stylu orkiestratora na dowolnym repozytorium: dzieli cel na fale, uruchamia równoległych subagentów, weryfikuje wyniki i commituje falami.
  • 100plan-orchestrate
    Czyta dokument planu, dzieli go na kroki i układa łańcuchy agentów w gotowe polecenia do wklejenia.

Uwagi i zgłoszenia

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