O que pi-dynamic-workflows faz?
Fluxos de trabalho dinâmicos no estilo Claude Code para Pi: subagentes em modo código com roteamento real de modelos, retomada com journaling, isolamento via git-worktree, contabilidade de custos, uma TUI interativa /workflows, um opt-in permanente /ultracode e pesquisa aprofundada.
Visão Geral
Esta skill permite que o Pi atue como um orquestrador de workflows dinâmicos, delegando tarefas a subagentes especializados que operam em um sandbox isolado. Inspirado no Claude Code, o sistema suporta:
- Roteamento Inteligente de Modelos: Cada subagente pode usar o modelo mais adequado para a tarefa (ex.: Claude Sonnet para raciocínio complexo, Gemini para busca, GPT-4o para criatividade).
- Journaling e Retomada: Todas as ações são registradas em um arquivo de journal (
workflow.journal), permitindo pausar e retomar workflows mesmo após falhas ou reinicializações. - Isolamento com git-worktree: Cada workflow é executado em uma worktree do Git separada, evitando conflitos com o diretório de trabalho principal.
- Contabilidade de Custos: Acompanha o custo de cada chamada de API por modelo, fornecendo relatórios detalhados ao final da execução.
- TUI Interativa: Comando
/workflowsabre uma interface TUI para listar, inspecionar e gerenciar workflows ativos e passados. - Modo Ultracode: Opt-in
/ultracodeativa funcionalidades avançadas, como execução paralela de tarefas e acesso a modelos de fronteira. - Pesquisa Aprofundada: Capacidade de realizar pesquisas na web com múltiplas fontes, extração de citações e sumarização.
Pré-requisitos
- Pi instalado e configurado.
- Git 2.5+ (para suporte a
git worktree). - Chaves de API configuradas para os modelos desejados (variáveis de ambiente:
ANTHROPIC_API_KEY,OPENAI_API_KEY,GEMINI_API_KEY, etc.).
Como Usar
Iniciar um Workflow
Use o comando /workflow seguido de uma descrição da tarefa:
/workflow Implementar um endpoint REST para listagem de usuários com autenticação JWT
O Pi criará um subagente, selecionará o modelo adequado e iniciará a execução em uma worktree isolada.
Comandos Disponíveis
/workflows– Abre a TUI interativa para gerenciar workflows./ultracode– Ativa permanentemente o modo ultracode para sessões futuras./research <consulta>– Executa uma pesquisa aprofundada na web.
Exemplo de Fluxo
- O usuário solicita uma tarefa complexa.
- Pi cria um workflow com ID único, aloca uma worktree e inicia o subagente.
- O subagente executa etapas, registrando cada ação no journal.
- Durante a execução, o usuário pode verificar o progresso via
/workflows. - Ao final, o Pi apresenta um resumo, incluindo custos e artefatos gerados.
Configuração
As seguintes variáveis de ambiente podem ser ajustadas:
| Variável | Descrição | Padrão |
|---|---|---|
PI_WORKFLOW_DIR | Diretório base para worktrees | ~/.pi-workflows |
PI_DEFAULT_MODEL | Modelo padrão para subagentes | claude-sonnet-4-20250514 |
PI_COST_LIMIT | Limite de custo por workflow (USD) | 10.0 |
PI_JOURNAL_RETENTION | Número de journals mantidos | 50 |
Exemplo de Journal
workflow_id: wf-20250315-abc123
created_at: 2025-03-15T10:30:00Z
model: claude-sonnet-4-20250514
steps:
- step: 1
action: create_file
path: src/routes/users.py
status: success
cost: 0.015
- step: 2
action: run_command
command: pip install fastapi
status: success
cost: 0.000
Suporte
Para dúvidas ou relatórios de bugs, abra uma issue no repositório oficial: QuintinShaw/pi-dynamic-workflows.