Azkae/agent-skills

Criar um novo shell de agente

Crie um novo shell de agente quando o usuário solicitar. O novo agente executa dentro do Emacs via agent-shell e trabalha em uma worktree git isolada.

Passos

1. Determinar os parâmetros

• Prompt: Em qual tarefa o novo agente deve trabalhar? Pergunte ao usuário se não estiver claro.
• Nome: Um nome curto em kebab-case para a worktree, baseado na tarefa (ex.: refatorar-auth, corrigir-login-bug, adicionar-dark-mode).
• Agente: Qual agente usar (ex.: claude, codex, opencode). Use o mesmo agente que está executando esta habilidade, a menos que o usuário especifique outro.

2. Criar a worktree

Crie uma worktree git dentro de .agent-shell/worktrees/ no repositório atual, em uma nova branch chamada agent/<nome>:

git worktree add -b "agent/<nome>" ".agent-shell/worktrees/<nome>"

3. Executar a configuração do repositório

Verifique a worktree em busca de instruções de configuração e execute-as. Procure por:

• CLAUDE.md, AGENTS.md, README.md — comandos de configuração/build/instalação
• Makefile — make setup ou make install
• package.json — npm install / npm ci / pnpm install / yarn install
• pyproject.toml / requirements.txt — uv sync / pip install -e .
• Gemfile — bundle install
• Cargo.toml — cargo fetch
• .env.example — copiar para .env

Execute os comandos de configuração dentro do diretório da worktree:

cd ".agent-shell/worktrees/<nome>" && <comando-de-configuração>

4. Iniciar o agente no Emacs

Chame emacsclient para iniciar o novo shell de agente:

emacsclient -e '(my/agent-shell-make
   :prompt "<descrição da tarefa>"
   :name "<nome-da-worktree>"
   :agent "<agente>"
   :directory "<caminho-absoluto-para-a-worktree>")'

Exemplo:

emacsclient -e '(my/agent-shell-make
   :prompt "Refatorar a autenticação para usar async/await. Veja @..."
   :name "refatorar-auth"
   :agent "claude"
   :directory "/Users/meu/projetos/meu-app/.agent-shell/worktrees/refatorar-auth")'

Use o caminho absoluto para :directory.

5. Relatar ao usuário

Informe ao usuário:

• O caminho da worktree e o nome da branch
• Qual configuração foi executada (ou que nenhuma configuração era necessária)
• Que o novo agente foi iniciado no Emacs

Regras

• Sempre crie a worktree dentro de .agent-shell/worktrees/ no repositório atual.
• Sempre crie uma nova branch chamada agent/<nome> para a worktree.
• Sempre use caminhos absolutos para :directory.
• Use o mesmo :agent que está executando esta habilidade, a menos que o usuário especifique outro.
• Execute todos os comandos através da ferramenta Bash.
• Se o Emacs não estiver em execução ou emacsclient falhar, relate o erro ao usuário junto com o comando manual para executar.