Adingo001/staffer

agy staffer

A persona de propósito geral: um ponto de entrada limpo para tarefas que nenhum dos especialistas atende. Seu modelo de prompt é deliberadamente mínimo — o texto da tarefa, o ambiente (diretório atual, branch, data), as regras de trabalho compartilhadas e as salvaguardas de segurança, nada mais. Sem definição de papel ou formato de corpo fixo: a tarefa define sua própria entrega, e nenhum contexto de modelo específico de domínio pode desviar a execução.

Prefira um especialista quando um se encaixar: researcher para pesquisas e análises aprofundadas, reviewer para segundas opiniões sobre código ou planos, implementer para edições na árvore de trabalho, ask para uma pergunta rápida e única.

O staffer também é a rota para ferramentas nativas do agy que nenhum especialista cobre — notavelmente geração de imagens: o agy vem com uma ferramenta generate_image (verificado na v1.1.15; um PNG de 1024×1024 em ~30s). Nomeie o caminho de saída na tarefa, por exemplo staffer --prompt "gere um mascote robô em pixel art, salve como assets/mascot.png".

Localizando o companheiro

Este arquivo de skill reside em <raiz-do-plugin>/skills/staffer/SKILL.md; resolva o caminho do companheiro relativo a este diretório de skill:

node "<dir-do-skill>/../../companion/agy-companion.mjs" staffer [flags] --prompt "tarefa"

Passe o texto da tarefa do usuário literalmente via --prompt; use --prompt-file <caminho> ou --stdin para textos longos.

[!IMPORTANT] Execute este comando sem sandbox — o agy precisa de uma porta localhost e seu arquivo de token OAuth, que os sandboxes de ambiente escondem. No Codex, solicite permissões elevadas para o comando. Detalhes: ../jobs/references/troubleshooting.md.

Coletando o resultado

O comando retorna um id de job. Leia ../jobs/SKILL.md para coleta e recuperação de resultados: despache, aguarde o resultado final e valide conforme necessário. Não observe proativamente o progresso, leia logs ou inspecione artefatos intermediários durante a execução. Observe apenas quando o usuário pedir explicitamente por progresso; diagnostique uma falha ou um resultado que exija intervenção sob o protocolo de jobs.

Flags (todas opcionais)

• --prompt <texto> / --prompt-file <caminho> / --stdin — a tarefa, de exatamente uma destas três fontes. Use arquivo/stdin para prompts longos em vez de aspas no shell.
• --model <id> ou --effort low|medium|high — o modelo padrão é gemini-3.8-flash-medium.
• --restricted / --unrestricted — perfil de permissão; staffer padrão é irrestrito como as outras personas que usam ferramentas, --restricted é o caminho de endurecimento opt-in.
• --continue (ou --conversation <id>), --timeout <dur> (padrão 60m, máximo 120m de limite de execução).

Regras

• Passe a tarefa do usuário literalmente. Como o modelo não impõe formato de saída, declare o formato desejado no texto da tarefa quando o chamador precisar de um específico.
• Passe as autorizações explícitas do usuário literalmente. O modelo nega por padrão efeitos colaterais custosos ou irreversíveis (commits/pushes, exclusão de arquivos fora do espaço de trabalho, chamadas de rede com efeitos colaterais, comandos com cota paga); esse padrão só é aberto quando a própria tarefa solicita a operação.
• Uma tarefa geral pode legitimamente editar arquivos. O companheiro relata qualquer delta na árvore de trabalho junto com o resultado — inspecione-o (git diff) e confirme que é o que a tarefa pediu antes de prosseguir.
• Para erros e recuperação, siga ../jobs/SKILL.md.

Para uma conversa existente, --continue / --conversation <id> herdam o modelo e o perfil de permissão registrados, a menos que explicitamente substituídos. Os padrões irrestritos acima se aplicam a novas tarefas.