dev-flow-pl

Wspólny standard współpracy człowieka i agentów AI: od ustalenia celu do sprawdzenia działającej zmiany po publikacji.

Status: standard v0.2 do pilotażu. Repozytorium zawiera źródła oraz pakiet pluginu do instalacji z własnego marketplace. Wersję i SHA sprawdzaj przed instalacją; obecność manifestu nie zastępuje odbioru ani pilotażu. Język materiałów: polski. Nazwy plików i skilli: angielskie.

Repozytorium dev-flow-pl udostępnia polskie instrukcje. Plugin zachowuje nazwę dev-flow, marketplace identyfikator aew, a skille prefiks aew-. Zmianę źródła istniejącej instalacji opisuje instrukcja.

Instalacja i aktualizacja w PowerShell

Wymagane są Codex CLI obsługujący pluginy, Git oraz dostęp do tego repozytorium. Jeśli repozytorium jest prywatne, potrzebne jest także uwierzytelnienie Git. Sprawdź dostępność poleceń:

codex --version
codex plugin add --help

Gdy PowerShell zgłasza, że nie rozpoznaje codex, użyj instrukcji poniżej.

Pierwsza instalacja

codex plugin marketplace add Grzejszczyk/dev-flow-pl --ref main
codex plugin add dev-flow@aew
codex plugin list --marketplace aew --json

--ref main wybiera gałąź main, której zawartość zmienia się po merge. Dla instalacji powtarzalnej wybierz pełny SHA zamiast main, zgodnie z instrukcją instalacji. Samo opublikowanie nowej wersji nie zmienia źródła przypiętego do starego SHA.

Aktualizacja istniejącej instalacji

Poniższa procedura ponownie instaluje plugin i pozwala przejść ze starego SHA na main. Najpierw sprawdź istniejące źródło i instalację:

codex plugin marketplace list --json
codex plugin list --marketplace aew --json

Potwierdź, że aew jest źródłem tego pluginu i nie udostępnia innych pluginów. Zapisz poprzedni adres źródła i pełny SHA, aby móc wrócić do instalacji. Poniższe polecenia zastępują źródło wersją z Grzejszczyk/dev-flow-pl:

codex plugin remove dev-flow@aew
codex plugin marketplace remove aew
codex plugin marketplace add Grzejszczyk/dev-flow-pl --ref main
codex plugin add dev-flow@aew
codex plugin list --marketplace aew --json

Jeśli krok zakończy się błędem, sprawdź stan przed kontynuacją. Na końcu potwierdź wersję zgodną z manifestem, installed: true i enabled: true. Rozpocznij nowy chat; jeśli aplikacja nadal pokazuje stare skille, uruchom ją ponownie. Wariant z przypiętym SHA i odzyskiwanie instalacji opisuje pełna instrukcja.

PowerShell nie rozpoznaje codex

Komunikat „codex nie jest rozpoznawany jako nazwa polecenia” oznacza, że PowerShell nie znajduje CLI. W aplikacji polecenie może być dostępne, chociaż zwykły terminal nie ma go w PATH.

Jeśli CLI jest już na dysku, poniższy przykład szuka go w typowym katalogu instalatora oraz w katalogach aplikacji Windows i tworzy alias w bieżącej sesji. Gdy znajdzie kilka plików, wybiera ostatnio zmodyfikowany:

$codexPaths = @(
    "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin\codex.exe"
    "$env:LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe"
)
$codexExe = Get-ChildItem -Path $codexPaths -File -ErrorAction SilentlyContinue |
    Sort-Object LastWriteTime -Descending |
    Select-Object -First 1

if ($null -eq $codexExe) {
    throw "Nie znaleziono codex.exe. Zainstaluj Codex CLI lub wskaż jego pełną ścieżkę."
}

Set-Alias -Name codex -Value $codexExe.FullName
codex --version

Alias działa tylko do zamknięcia tego okna PowerShella; nie zmienia trwale PATH ani profilu użytkownika. Następnie można wykonać powyższe polecenia codex plugin …. Przy innej lokalizacji wskaż istniejący codex.exe:

Set-Alias -Name codex -Value 'C:\sciezka\do\codex.exe'

Zastąp przykładową ścieżkę własną. Jeśli CLI nie jest zainstalowany, skorzystaj z oficjalnej instrukcji instalacji Codex CLI i otwórz nowe okno PowerShella.

Zacznij tutaj

1. Aby używać pluginu w Codex, wykonaj instalację. Przy adaptacji projektu przeczytaj przebieg pracy i granice uprawnień.
2. Wybierz konkretny commit standardu i przygotuj profil projektu.
3. Zastosuj instrukcję wdrożenia standardu.
4. Sprawdź rezultat według zasad weryfikacji.
5. Oceń pierwsze zadania przy użyciu scenariuszy pilotażu.

Co jest gdzie

Skille

Katalog skills/ jest wspólnym źródłem procedur i pluginu. Samo sklonowanie repozytorium nie instaluje skilli. Instalację opisuje instrukcja, a zastosowanie w projektach adopcja. Rzeczywisty wynik instalacji i wykrywania skilli opisuje odbiór.

Zasady projektowania

• Kryteria akceptacji i dowody weryfikacji określają ukończenie zadania.
• Zakres procedury zależy od ryzyka: literówka nie wymaga pełnego planu ani ADR.
• Uzgodnione decyzje, propozycje, niewiadome i obserwacje mają odrębny status.
• Jedna informacja ma jedno utrzymywane źródło; pozostałe pliki do niego odsyłają.
• Instrukcje wspierają wykonanie; kontrole CI i ustawienia repozytorium egzekwują wybrane wymagania technicznie.
• Standard nie nadaje uprawnień do cudzych systemów ani do produkcji.

Rozwój v0.2

Pierwszy pilotaż powinien objąć małą poprawkę, funkcję z testami i zmianę wymagającą analizy migracji. Wnioski trafiają do PR zmieniającego standard. Pakiet pluginu jest częścią repozytorium. Konfiguracja ochrony main, gotowy template repozytorium i publikacja wydania pozostają odrębnymi zadaniami. Obecne szablony są pojedynczymi materiałami, a nie kompletnym generatorem projektu.

Weryfikacja repozytorium

Wymagany Python 3.11+; walidator i jego testy korzystają wyłącznie z biblioteki standardowej.

python scripts/validate.py
python scripts/validate_evals.py
python -m unittest discover -s tests -v
git diff --check

W tym repozytorium nie skonfigurowano GitHub Actions. Powyższe kontrole uruchamiaj lokalnie i podawaj ich wyniki przy przygotowaniu PR.

Walidacja struktury nie potwierdza skuteczności workflow ani zachowania modelu. Katalog przypadków i przebiegi na żądanie opisuje ewaluacja, a zakres wykonanych prób raport. Do tego służy pilotaż; jego wyników nie należy deklarować przed wykonaniem.

Źródła techniczne

Sprawdzone 2026-10-29. Materiały opisują nasz proponowany proces; poniższe źródła wyjaśniają mechanizmy Codex, na których opieramy dystrybucję.

• Instrukcje AGENTS.md
• Tworzenie i odkrywanie skilli
• Pakowanie pluginu

Licencja

Materiały są udostępniane na licencji MIT.