convez.ai
SkillAutomaçãoAvançado
ArturWilczek

Claude Code Skills — Workflow de Desenvolvimento Dirigido por IA

ArturWilczek/claude-skills-1

Orquestra desenvolvimento full-stack com agentes IA especializados

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto de skills especializados para Claude Code que implementam um workflow repetível onde agentes IA atuam como membros de equipe (planejador, executor, technical writer, secretário) enquanto humanos focam em arquitetura e requisitos. Inclui skills para atualizar tarefas, executar implementações, gerar documentação de API e guias de usuário.

Instalação

$npx convez-ai ArturWilczek/claude-skills-1

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar planejamento e execução de tarefas de desenvolvimento com rastreamento em TASKS.md
  • Gerar e manter documentação de API sincronizada com o código em tempo real
  • Implementar workflow repetível com especificações em SPEC.md, planos em _TASKS/ e guias de usuário

Veredito

Excelente abordagem para equipes que usam Claude Code — estrutura clara de skills especializados reduz overhead de contexto e permite paralelização de tarefas. Requer disciplina na convenção de arquivos e documentação, mas entrega ROI alto em projetos médios/grandes.

README

A tradução para o português deste README ainda está na fila.

Claude Code Skills — AI-Driven Development Workflow

Zestaw SKILL-i Claude Code, które posłużyły do zbudowania i utrzymania realnej aplikacji w ramach AI-Driven Development Workflow — powtarzalnego procesu, w którym agenci AI pełnią rolę wyspecjalizowanych członków zespołu (planista, wykonawca, technical writer, sekretarz), a człowiek skupia się na architekturze, wymaganiach i weryfikacji.

Pełny opis procesu, kontekst powstania każdego SKILL-a oraz wnioski z pracy znajdziesz w artykule: 👉 AI-Driven Development Workflow

SKILL-e powstały przy okazji aplikacji CPW (rejestrowanie pomiarów ciśnienia, pulsu i wagi), ale są na tyle ogólne, że nadają się do większości projektów prowadzonych z Claude Code. Część z nich zakłada konwencję plików SPEC.md / CLAUDE.md / TASKS.md / API.md / GUIDE.md opisaną w artykule — dostosuj je do własnego projektu, jeśli używasz innych nazw.


Zawartość

SKILLRolaOpis
update-tasks-listPlanistaCzyta specyfikację (SPEC.md, CLAUDE.md) i dopisuje do TASKS.md zadania ułożone logicznie — od bazy danych, przez REST API, po frontend. Dla każdego zadania tworzy plik planu w _TASKS/NNNN.md.
do-taskWykonawcaRealizuje zadanie o podanym numerze zgodnie z planem w _TASKS/NNNN.md, a po zakończeniu aktualizuje jego status w TASKS.md.
update-taskKorygującyAktualizuje plik zadania NNNN.md o nowe wymagania (nowa funkcja, rozbudowa, poprawka) i od razu wprowadza zmianę w kodzie.
update-specAnalityk biznesowyWbudowuje nową funkcjonalność / zmianę koncepcyjną w SPEC.md (i w razie potrzeby CLAUDE.md), dbając o spójność dokumentów.
cleanup-specPorządkowyUsuwa duplikacje między SPEC.md, CLAUDE.md i plikami zewnętrznymi (np. API.md), porządkuje strukturę i odchudza kontekst.
update-api-docTechnical writer (API)Tworzy lub aktualizuje API.md — kompletną dokumentację endpoint-ów REST API (URL, metoda, dane wejściowe, autoryzacja, opis biznesowy).
update-user-guideTechnical writer (użytkownik)Tworzy lub aktualizuje GUIDE.md — instrukcję dla użytkownika końcowego ze zrzutami ekranów wykonanymi przez Playwright na danych testowych.
commit-stagedSekretarzPrzygotowuje commit message (po polsku) dla plików w statusie staged, wykonuje commit, a na końcu zawsze pyta, czy zrobić git push.

Pętla rozwojowa

Główna:
  pomysł → /update-spec → /update-tasks-list → /do-task <nr> → (/update-task <nr> <opis>)* → /commit-staged

Pomocnicza:
  ↘ /update-api-doc, /update-user-guide   (regularnie)
  ↘ /cleanup-spec                          (okresowo)

Instalacja

SKILL-e instalujesz jednym poleceniem za pomocą npx skills — menedżera skilli dla agentów AI (Claude Code, Cursor, Codex i inne). Uruchom je w katalogu swojego projektu.

Cały zestaw

npx skills add ArturWilczek/claude-skills-1

Polecenie wyświetli listę dostępnych SKILL-i — zaznacz wszystkie lub wybierz interesujące Cię.

Pojedynczy SKILL

npx skills add ArturWilczek/claude-skills-1 --skill commit-staged

Wszystkie bez pytania (np. w CI)

npx skills add ArturWilczek/claude-skills-1 --all

SKILL-e trafiają do .claude/skills/<nazwa>/SKILL.md w Twoim projekcie. Aby zainstalować je globalnie (dla wszystkich projektów), dodaj flagę --global.

Użycie

Uruchom (lub zrestartuj) Claude Code w katalogu projektu i wywołaj wybrany SKILL poleceniem /<nazwa-skilla>:

/update-tasks-list
/do-task 1
/update-task 4 Przycisk submit ma być nieaktywny gdy formularz niepoprawny
/commit-staged

Konwencje plików projektu

Część SKILL-i zakłada następujący podział dokumentacji (możesz go dostosować, edytując pliki SKILL.md):

  • SPEC.md — warstwa biznesowa i funkcjonalna: co robi aplikacja.
  • CLAUDE.md — warstwa techniczna i pamięć projektu: jak agent ma pracować z kodem (generowany przez wbudowane /init).
  • TASKS.md + _TASKS/NNNN.md — lista zadań i szczegółowe plany realizacji.
  • API.md — pełna dokumentacja endpoint-ów REST API.
  • GUIDE.md — instrukcja dla użytkownika końcowego.

Licencja

Projekt jest dostępny na licencji MIT — możesz go używać, kopiować, modyfikować i redystrybuować, także komercyjnie, zachowując notę o autorstwie. Jeśli SKILL-e okażą się pomocne — daj znać lub podlinkuj artykuł. 🙌

Ver o original no GitHub

Bom para

Relacionados