specsfy-progress
Projeta, sem escrever nada, o progresso de todas as specs do projeto: denominadores de specs, gates, tarefas e checklists, ato atual, blockers reais e próximo par TNNN/ITEM pronto. Use quando o usuário pedir progresso geral, status das especificações, percentual concluído, quanto falta, bloqueios ou próximo trabalho, ou quando uma transição automática pedir a projeção final ou o roteamento pelo estado observado. Não use para alterar spec, gates ou checkboxes (use a skill responsável, como specsfy-07-implement ou specsfy-update-spec).
How do I install this agent skill?
npx skills add https://github.com/promovaweb/specsfy --skill specsfy-progressIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill tracks project progress by scanning local specification files. It includes features for automatic project state transitions and optional installation of vendor-provided extensions from the author's GitHub repository. While the skill processes project data, it focuses on structured parsing to report status.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Informar progresso geral
Esta skill responde onde o projeto está e qual é o próximo passo. O relatório
é uma projeção de specs/<estado>/*/spec.md, nunca uma segunda fonte de
estado: nada é editado durante a consulta.
Pronto quando
- O relatório traz os denominadores de specs, gates, tarefas e itens de checklist, calculados pelos scripts.
- Cada spec que exige atenção aparece com seu blocker e a skill responsável.
- Pendências de contexto e de documentação foram projetadas pelos checks.
- O próximo trabalho foi indicado e, quando acionável, a transição automática foi executada.
Preparação obrigatória
Antes de executar esta skill, carregue obrigatoriamente $specsfy-setup na
raiz do projeto. Em handoff automático, carregue-o de novo antes desta etapa.
Reutilize a raiz confirmada na conversa e não prossiga se o setup apontar uma
pendência.
Modo de interação
Modo de interação: sem perguntas.
Não formule perguntas nesta skill. Apresente a projeção observada e o próximo
handoff aplicável.
Orquestrar a conversa
Siga a seção Orquestração conversacional de .specsfy/Spec.md. Resumo:
- Pendência dentro do escopo: anuncie
Pendência detectada: <descrição> — ação: resolvendo nesta etapae resolva. - Troca de responsabilidade: anuncie
Transição automática: $specsfy-progress → $<destino> — motivo: <motivo> — resultado esperado: <resultado>e carregue imediatamente a skill de destino, sem pedir confirmação nem repetir o comando. Continue na mesma conversa. - Correção concluída: anuncie
Retomada automática: $<destino> → $specsfy-progress — pendência resolvida: <resultado>e retome.
Reavalie o estado depois de cada handoff para não entrar em ciclo. O handoff dispensa confirmação; ações sensíveis continuam exigindo autorização específica.
Executar
Na raiz do projeto, os comandos abaixo são independentes e podem rodar em paralelo.
| Objetivo | Comando | Tool MCP |
|---|---|---|
| progresso geral | specsfy progress | project_status |
| dados para automação | specsfy progress --json | project_status |
| uma única spec | specsfy progress --spec <spec> | project_status |
| custo de contexto de uma spec | specsfy context usage <spec> --json | context_usage |
| contexto persistente | specsfy context monitor --project . --check | context_monitor |
| documentação técnica | specsfy docs build --project . --check | docs_build |
Sem o binário instalado, use os scripts equivalentes:
node .agents/skills/specsfy-progress/scripts/progress.mjs . --json
node .agents/skills/specsfy-progress/scripts/analyze_context.mjs specs/<estado>/<NNNN>-<slug>/spec.md --json
node .agents/skills/specsfy-setup/scripts/monitor_context.mjs --project . --check
node .agents/skills/specsfy-documentator/scripts/build_documentation.mjs --project . --check
PENDINGno monitor de contexto é blocker da entrega: anuncie o handoff indicado pelo monitor e retome depois que a auxiliar atualizar o documento ou que a avaliação sem impacto estiver registrada e reconhecida.- Documentação ausente ou desatualizada no segundo check leva a
$specsfy-documentator; retome a projeção depois da reconstrução dedocs/. - Sem
--usage-json, o custo de contexto sai rotuladoestimatede descreve a heurística. Só métricas fornecidas explicitamente sãomeasured; não apresente estimativa como uso real.
Interpretar
- Informe os denominadores de specs, gates, tarefas e itens de checklist.
- Mostre o ato atual e a próxima skill responsável, ambos derivados do
Status. - Separe spec concluída, trabalho em progresso e blocker real.
- Mostre o próximo par
TNNN/ITEMpronto quando existir. - Classifique como blocker: gate
Failed, inconsistência de checklist, dependência sem caminho pronto, documentação obrigatória apontada porspecsfy context monitor(mesmo com todos os checkboxes marcados) edocs/ausente ou desatualizado segundo$specsfy-documentator. Um gateIn Progressisolado não é falha. - Se uma spec existente exigir mudança de comportamento ou de plano, anuncie a
pendência e carregue automaticamente
$specsfy-update-spec. Retome a projeção depois que a atualização percorrer os atos invalidados. - Sem nenhuma spec, preserve o código de saída 2. Capturas em
specs/inbox/e itens emspecs/backlog/não contam como progresso normativo. Se o pedido também exigir avançar uma captura, carregue$specsfy-02-backlog; se já houver intenção e definição suficientes, carregue$specsfy-03-specify.
Preservar a fonte
- Não edite specs, checkboxes, testes ou código durante a consulta.
- A descoberta é exatamente
specs/<estado>/*/spec.md; não contespec.mddentro deresearch/. - Não deduza progresso de commits, arquivos soltos ou memória do chat.
- Para mudar estado, anuncie e carregue a skill responsável na mesma conversa e retome o progresso depois.
Relatar
Entregue primeiro o resumo global, depois as specs que exigem atenção, os blockers e o próximo trabalho. Quando houver etapa acionável, anuncie e execute a transição automaticamente. Se o usuário pedir automação ou dados estruturados, use a saída JSON sem renomear campos.
Especialistas sob demanda
Leia references/specialists.md somente para propor contexto para a próxima tarefa. Carregue automaticamente a skill base ou o especialista já instalado que seja responsável; instalação exige autorização específica.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/promovaweb/specsfy/specsfy-progress">View specsfy-progress on skillZs</a>