mosonlab/sandcastle-loop

O que sandcastle-loop faz?

Habilidade do Claude Code para processar em lote e concorrentemente um backlog de issues do GitHub — ciclo de três fases, reutilizando a assinatura do Claude, zero API / zero Docker.

Como funciona

O sandcastle-loop opera em três fases:

1. Coleta: Busca issues do GitHub a partir de um backlog (filtro configurável, como is:issue is:open).
2. Processamento: Para cada issue, executa uma análise e sugere ações (ex.: comentar, fechar, atribuir) usando o Claude Code de forma concorrente.
3. Conclusão: Aplica as ações decididas (ex.: fechar issues resolvidas, comentar com sugestões de correção).

As issues são processadas em paralelo, respeitando limites de taxa do GitHub e da sessão do Claude.

Requisitos

• Claude Code instalado e configurado.
• Acesso a um repositório do GitHub (token clássico com permissões repo ou public_repo).
• Nenhuma dependência de Docker ou serviços externos.

Configuração

1. Copie este diretório de skill para ~/.claude/skills/sandcastle-loop/.
2. Defina a variável de ambiente GITHUB_TOKEN com um token de acesso pessoal do GitHub.
3. (Opcional) Configure o filtro de issues via GITHUB_ISSUES_QUERY (padrão: repo:owner/repo is:issue is:open).

Uso

No Claude Code, execute:

/skill sandcastle-loop

Ou, para iniciar imediatamente:

/skill sandcastle-loop run

O skill irá:

• Listar as issues pendentes.
• Processar cada uma com um prompt personalizado.
• Exibir resumo das ações executadas.

Estrutura de arquivos

• SKILL.md — este arquivo.
• sandcastle-loop.py — script principal do ciclo.
• prompts/ — diretório com templates de prompt.

Licença

MIT