track-management

Visão Geral

A skill track-management foi criada para equipes e indivíduos que precisam organizar, planejar e acompanhar unidades de trabalho — chamadas "tracks" — dentro do fluxo de trabalho Conductor. Tracks representam unidades lógicas de trabalho, como funcionalidades, correções de bugs ou refatores, e são gerenciadas por meio de um processo estruturado que envolve especificação (spec.md), planejamento (plan.md) e operações de ciclo de vida. Essa skill é ideal para cenários de gestão de projetos onde limites claros de trabalho, acompanhamento de progresso e coordenação da equipe são essenciais.

As tracks são identificadas de forma única e incluem metadados sobre status e progresso, facilitando o gerenciamento de projetos complexos e garantindo responsabilidade. A skill suporta vários tipos de tracks, incluindo funcionalidades, bugs e tarefas, cada um com suas próprias convenções e melhores práticas.

Como Usar

Passos para Instalação

• Instale a skill usando o seguinte comando:

  npx skills add https://github.com/wshobson/agents --skill track-management
  

Configuração Inicial e Arquivos

• Comece revisando o arquivo SKILL.md para um guia geral.
• Explore arquivos de suporte como README.md, AGENTS.md, metadata.json e quaisquer diretórios rules/, resources/, references/ ou scripts/ para contexto adicional e automação.
• O fluxo de trabalho é adaptável — personalize-o para se adequar à estrutura do seu repositório, ferramentas e processos da equipe.

Gerenciando Tracks

• Use a skill ao criar novas tracks para funcionalidades, bugs ou refatores.
• Escreva ou revise arquivos spec.md para definir os requisitos.
• Crie ou atualize arquivos plan.md para detalhar o trabalho em tarefas acionáveis.
• Gerencie o ciclo de vida da track desde a criação até a conclusão, atualizando marcadores de status e metadados conforme o trabalho avança.
• Consulte tracks.md para um registro de todas as tracks ativas e concluídas.

Cenários Ideais

• Equipes que utilizam Git ou GitHub para gestão de projetos e acompanhamento de issues.
• Projetos que se beneficiam de organização semântica do trabalho e acompanhamento claro do progresso.
• Fluxos de trabalho que exigem especificação, planejamento e gestão do ciclo de vida para cada unidade de trabalho.

Perguntas Frequentes

O que é uma "track" no track-management?

Uma track é uma unidade lógica de trabalho que representa uma funcionalidade, bug ou refatoração. Cada track é gerenciada por meio das fases de especificação, planejamento e implementação, com metadados para acompanhar status e progresso.

Quem deve usar a skill track-management?

Essa skill é ideal para gerentes de projeto, líderes de equipe e desenvolvedores que desejam uma gestão estruturada e integrada ao Git para projetos e acompanhamento de issues dentro de seus repositórios.

Como começo a usar o track-management?

Instale a skill conforme descrito acima, depois revise o SKILL.md e os arquivos relacionados. Adapte o fluxo de trabalho às necessidades da sua equipe e comece a criar tracks para suas unidades de trabalho.

Posso usar o track-management para projetos que não envolvem código?

Embora otimizada para repositórios de código, a skill track-management pode ser adaptada para qualquer projeto que se beneficie de unidades de trabalho estruturadas e acompanhamento do ciclo de vida.

Onde encontro mais detalhes ou scripts?

Abra a aba Files no repositório para explorar toda a árvore de arquivos, incluindo referências e scripts auxiliares para uso avançado.