Mampu-AI/claude-skills

Loop de trabalho

As ferramentas vêm com o servidor mampu-tech-team deste plugin: team_work_guide, team_tasks_open, team_task_start, team_task_milestone, team_task_finish, internal_doc_search, internal_doc_get, internal_doc_save. As regras estão no servidor: busque a seção loop de team_work_guide antes do primeiro team_task_start de uma sessão e siga-as; busque status-block, records ou public-docs quando precisar. Os hooks informam os candidatos para cada prompt; você decide.

As três chamadas

1. team_task_start — no primeiro prompt que for trabalho. Passe o task_guid que o contexto do prompt ofereceu, ou create: {titulo, descricao} quando nada corresponder. Nunca pergunte à pessoa se deve iniciar uma tarefa: inicie e informe isso no bloco.
2. team_task_milestone — quando um PR é aberto ou mesclado, ou uma promoção é executada (kind: pr_opened, pr_merged, promoted; a URL quando conhecida).
3. team_task_finish — antes da sua resposta final: state done, doing, waiting ou blocked; o resumo de uma linha; debrief {como, armadilhas, descobertas}; changed_paths; records para escrever ou atualizar; help_pages_checked com um veredito por página — unchanged, needs_update ou missing com suggested_title, section e why_public (a seção public-docs diz o que é público); pr_url quando existir um PR. Uma página sinalizada faz o servidor registrar uma solicitação de docs no repositório de help-doc; se você puder capturar screenshots reais, também escreva a página lá com o skill help-doc-writing do próprio repositório e abra um PR de rascunho. Nunca peça à pessoa para finalizar a tarefa. Done quando o trabalho estiver ativo e verificado: pequenos itens restantes (uma oferta de docs, uma limpeza, acompanhar o primeiro caso em produção) vão no resumo e não mantêm a tarefa aberta. Waiting = depende do proprietário ou de um cliente; o resumo diz quem e para quê. Doing = alguém ainda está trabalhando nela.

O bloco de status

Abra a resposta que inicia o trabalho com estas quatro linhas e encerre novamente com elas. Vocabulário fixo: found / not found / created / updated / unchanged / done / doing / waiting / blocked. O servidor renderiza as linhas (block_line, block); imprima-as, nunca pule-as, mesmo quando todas as quatro forem nenhuma.

Task:      <título> — found, open → marked doing | not found → created "<título>", doing | <título> — done, completed | … doing, note left | … waiting: <quem, para quê> | … blocked: <porquê>
Records:   <slug> — found, reading it | none match → will write one at close-out | <slug> — updated | <slug> — created | <slug> — unchanged
Help page: <título> — found, will check after the change | none mention <tópico> | <título> — checked, no change needed | <título> — needs update, flagged | <título> — missing, page proposed | …; docs request #<n>
Client:    none on this task

Tarefas obsoletas

Uma vez por dia, o início da sessão lista suas tarefas obsoletas (enviadas mas ainda abertas ou nunca registradas, após três horas; ou intocadas por um dia, três dias para waiting). Antes de outro trabalho, mostre à pessoa essa lista numerada e pergunte em uma linha quais estão done, waiting (em quem), blocked ou ainda doing, então chame team_task_finish para cada uma a partir da resposta. Nunca feche uma tarefa obsoleta sem a palavra do proprietário.

Não é essa?

Quando a pessoa disser que a tarefa está errada, chame team_task_start novamente com o task_guid correto (ou create); o servidor reverte a anterior. Imprima o bloco novamente.

Regras

• Nenhum detalhe de código em nada que o loop registre. Títulos de tarefas, resumos, notas de marco, debriefs e registros descrevem o resultado e o procedimento em termos de produto: a tela, a configuração, o comportamento, o comando que uma pessoa digita. Nunca caminhos de arquivos fonte, nomes de funções, classes, módulos ou tabelas, trechos de código ou SQL, chaves de configuração. O produto é propriedade intelectual protegida, e a lista de tarefas e os registros alcançam pessoas que podem não ler seu código. O servidor recusa um registro ou um encerramento que contenha detalhes de código; reescreva e chame novamente.
• Nunca peça, aceite, imprima ou armazene o token de acesso da pessoa. Se um for colado, diga a ela para redefini-lo em seu perfil Sapot e salvá-lo novamente com o save-token.sh do plugin.
• Uma recusa de ferramenta ("Missing Sapot credentials", "Not allowed", "switched off") significa parar e dizer à pessoa para verificar a configuração do plugin com seu administrador Mampu; nunca contorne isso.