Communitygithub.com

Helix

Avança trabalhos incertos fechando um loop de evidência de cada vez. Cadência é uma transição **Arranjar → Agir → Afirmar/Colapsar** completa; o volume de atividade não é progresso.

O que é Helix?

Helix é uma habilidade de agente especializada em gerenciar progresso de trabalho incerto através de loops de evidência bem definidos. Em vez de medir volume de atividade, ela foca em transições completas de Arranjar → Agir → Afirmar/Colapsar como única métrica de progresso. A habilidade é útil para agentes de IA que precisam lidar com tarefas complexas onde o resultado é desconhecido, garantindo que cada passo seja verificado antes de prosseguir. Ela impõe leis de transição visíveis, como exigir um checkpoint antes de trabalhar, arranjar antes de agir, agir uma única vez, afirmar antes do próximo ato e colapsar cada movimento encerrado. Helix suporta plataformas de agentes como Claude Code, Cursor e Codex, fornecendo um fluxo estruturado de leitura de checkpoint, expansão de branches, execução de um movimento e colapso com resultados. Ela também carrega seções específicas de um documento de referência para casos de borda, como configurar checkpoints, reparar links, resolver evidências mistas ou inconclusivas, e retirar ou reanimar trabalho. O resultado é um checkpoint com referência, próximo movimento e quaisquer órfãos ou bloqueios de autoridade, garantindo que o agente nunca invente arquivos ou serviços sem autorização explícita do usuário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add theKashey/skills

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Helix faz?

Avança trabalhos incertos fechando um loop de evidência de cada vez. Cadência é uma transição completa Arranjar → Agir → Afirmar/Colapsar; o volume de atividade não é progresso.

Mantenha as leis de transição visíveis

  • Checkpoint antes do trabalho. Exija uma superfície, referência, representação e autoridade de leitura/escrita explicitamente configuradas. Se faltar qualquer uma, retorne NEEDS-HUMAN-DECISION; nunca invente um arquivo, serviço ou transcript como fallback. O prompt persistido ou arquivo de plano de um loop estilo Ralph ou de meta carrega execução e intenção, não aprendizado; trate-o como o checkpoint apenas quando o usuário o configurou como a superfície.
  • Arranjar antes de Agir. Congele a situação ou necessidade fornecida, efeito pretendido e prova, autoridade e limite, contribuição da branch selecionada, escopo máximo de um movimento, fonte de observação, ponto de revisão e leituras esperadas e desconfirmadoras. A falta de enquadramento torna Próximo um reparo ou bloqueio, nunca permissão para experimentar. Helix sequencia um movimento fornecido; ela não classifica o regime causal nem projeta a sonda. Quando instalada, 'Ler o Terreno' é responsável por esse trabalho upstream.
  • Agir uma vez. Mantenha um movimento em voo. Dê ao seu executor apenas o limite de resultado, contribuição da branch, movimento, fonte de observação, ponto de revisão e leituras. Pare na primeira leitura, ponto de revisão ou limite.
  • Afirmar antes de outro Agir. Acrescente a observação imutável ao lado das leituras congeladas e classifique-a como Esperada, Desconfirmadora, Mista ou Inconclusiva. Esforço, confiança e narração retrospectiva do produtor não são evidência.
  • Colapsar cada movimento encerrado. Classifique o trabalho entregue ao seu arquivo de registro, trabalho aposentado a um epitáfio e todo o resto ao descarte deliberado. Reescreva o checkpoint com exatamente um Próximo antes de outro Agir.

O checkpoint armazena vereditos, não deliberação: resultado, branches sobreviventes, movimentos arranjados ativos e resultados, links abertos, epitáfios e um Próximo. Re-derive candidatos e classificação a cada ciclo. Uma leitura correspondente estabelece apenas o que foi observado dentro de seu limite; ela não prova valor, correção ou causalidade.

Execute o estado atual

Comece na primeira transição incompleta; nunca repita uma fase concluída.

  1. Leia o checkpoint inteiro.
  2. Expandir: derive branches do resultado e dos resultados mais recentes; descarte qualquer candidato cujos resultados possíveis deixem a próxima decisão inalterada. Verifique condições de ressurreição de epitáfio, selecione uma branch e mantenha a inspeção de implementação atrás do movimento arranjado.
  3. Spike: Arranje, depois Aja uma vez.
  4. Colapsar: Afirme, classifique o movimento encerrado, reescreva o checkpoint e selecione um Próximo.

Carregue apenas a seção aplicável de checkpoint e casos de borda:

  • configure ou reconstrua um checkpoint;
  • repare um link órfão ou desconhecido;
  • resolva evidências Mista ou Inconclusiva;
  • aposente, ressuscite, tente novamente ou descarte trabalho.

Retorne a referência do checkpoint, Próximo, e todo órfão, link desconhecido ou bloqueio de autoridade.

Habilidades Relacionadas