Flow Next Plan

Przekształca żądania funkcji lub identyfikatory Flow w ustrukturyzowane specyfikacje .flow z zadaniami o określonym rozmiarze, bez kodu

Autor: gmickel · gmickel/flow-next

Działa po konfiguracji ★ 8.8/10

Flow Next Plan — Przekształca żądania funkcji lub identyfikatory Flow w ustrukturyzowane specyfikacje .flow z zadaniami o określonym rozmiarze, bez kodu

Co robi ten skill

Umiejętność planowania dla wtyczki flow-next, która konwertuje żądanie funkcji lub istniejący identyfikator Flow w ustrukturyzowaną specyfikację oraz zadania o odpowiednim rozmiarze przechowywane w .flow/ za pośrednictwem dołączonego flowctl CLI, egzekwując testowalne kryteria akceptacji R-ID i zasadę braku kodu implementacyjnego. Uruchamia się na polecenie slash /flow-next:plan z opisem tekstowym lub identyfikatorem Flow (fn-1-add-oauth, fn-1-add-oauth.2). Tylko planuje; implementacja odbywa się później w /flow-next:work.

Raport z testu

Sklonowano repozytorium i uruchomiono dołączony flowctl (Python) w tymczasowym HOME: `init` utworzył .flow/, `spec create` + `spec set-plan` + `task create` wygenerowały rzeczywistą specyfikację i zadanie, a `validate --spec` zwróciło valid:true, task_count:1. Zbudowano dwa artefakty dla „rate limit the login endpoint”: bazowy plan (15-liniowa implementacja JS rateLimit kopiuj-wklej, jedno zadanie grupujące 9 zagadnień, akceptacja = „it works and blocks too many logins”) vs. specyfikacja zgodna z umiejętnością (tylko sygnatura `function rateLimit(req,res,next):void`, jawny Scope IN/OUT, pięć numerowanych, testowalnych kryteriów akceptacji R1-R5, jedno zadanie o rozmiarze M, ujawnione otwarte pytanie) — wersja umiejętności została poprawnie zweryfikowana przez flowctl. NIE MOŻNA było uruchomić obowiązkowego równoległego rozgałęzienia scout (repo-scout/docs-scout to subagenty wtyczki), so file:line reuse refs stayed as placeholders; that plus the plugin-runtime dependency (flowctl only resolves after installing the whole plugin and running /flow-next:setup) is the setup friction. Wszystkie odwołane pliki (steps.md, examples.md, references/html-artifacts.md, scripts/flowctl) zwróciły HTTP 200; brak zagrożeń bezpieczeństwa — brak curl|sh, blobów base64 lub eksfiltracji.

Testowano: 2026-07-21 · Claude Code 2.x (agent harness)

Instalacja

git clone --depth 1 https://github.com/gmickel/flow-next.git /tmp/flow-next-plan-src
mkdir -p ~/.claude/skills
cp -R /tmp/flow-next-plan-src/plugins/flow-next/skills/flow-next-plan ~/.claude/skills/flow-next-plan
# IMPORTANT: this skill is a COMPONENT of the flow-next plugin and is NOT functional as a
# lone skill copy. It calls a bundled flowctl at $CLAUDE_PLUGIN_ROOT/scripts/flowctl (unset
# for a standalone skill) then falls back to .flow/bin/flowctl, which only exists AFTER setup.
# Proper install is via the plugin marketplace, then run setup to scaffold .flow/ and flowctl:
#   /plugin marketplace add gmickel/flow-next
#   /plugin install flow-next
#   /flow-next:setup          # creates .flow/ and .flow/bin/flowctl
# Invoke (skill is user-invocable:false — driven by the command): /flow-next:plan <feature or fn-ID>
# Deps: python3 (flowctl runtime), jq. flowctl is zero-dependency pure-stdlib Python.

Komendy i przykładowe prompty

  • /flow-next-planPrzekształca żądania funkcji lub identyfikatory Flow w ustrukturyzowane specyfikacje .flow z zadaniami o określonym rozmiarze, bez kodu

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

  • Plan the implementation for the fn-1-add-oauth spec
  • Create a build plan from this feature request
  • Design the implementation steps for this Flow spec