ax Workflow de Extração

Visão Geral

Use esta habilidade para reconstruir o fluxo de trabalho por trás de um artefato de agente de codificação passado: um recurso enviado, PR, demonstração, refatoração, relatório ou outro resultado concreto. Ele usa o grafo local ax para conectar commits, sessões, turnos, habilidades e rastros de ferramentas em uma curta narrativa de "como isso foi feito".

ax deve ser instalado, disponível em PATH e capaz de alcançar seu banco de dados local. Se o ax não conseguir se conectar ao seu banco de dados, relate a falha de conexão e pare em vez de adivinhar pela memória.

Quando Usar Esta Habilidade

• Use quando o usuário perguntar "como construímos X?", "o que fez X funcionar?" ou "extraia o fluxo de trabalho por trás deste artefato."
• Use quando a âncora for um SHA de commit, data, nome de recurso, PR, sessão ou artefato local do repositório.
• Use quando o usuário quiser a sequência de habilidades do agente, prompts, comandos, decisões e verificações que levaram a um resultado.
• Não use para um resumo genérico de atividade; use a listagem normal de sessões em vez disso.

Como Funciona

Passo 1: Resolver a Âncora

Identifique a melhor âncora a partir da solicitação do usuário:

• SHA de Commit: use-o diretamente.
• Data ou intervalo de datas: inspecione sessões em torno da data.
• Tópico, recurso ou nome do artefato: pesquise no recall por turnos, commits e habilidades relacionadas.
• "Este repositório recentemente": liste sessões recentes para o repositório atual.

ax recall "live ingest dashboard" --sources=turn,commit,skill --scope=here
ax sessions near abc1234 --json
ax sessions around 2026-06-15 --days=3 --json
ax sessions here --days=14

Esses comandos são comandos de inspeção somente leitura.

Passo 2: Escolher Sessões Relevantes

Escolha as poucas sessões mais prováveis de explicar o artefato. Prefira sessões que mencionam o artefato, tocam em arquivos relacionados, incluem commits relevantes ou têm habilidades e chamadas de ferramentas que correspondem ao trabalho.

Se vários candidatos forem plausíveis, mostre ao usuário os candidatos e pergunte qual inspecionar.

Passo 3: Inspecionar o Rastro da Sessão

Abra cada sessão selecionada e procure por:

• habilidades usadas e sua ordem
• pontos de direcionamento do usuário e restrições esclarecidas
• arquivos, testes e comandos que mudaram a direção do trabalho
• rastros de subagente ou ferramenta que produziram evidências chave
• etapas de verificação antes que o resultado fosse considerado concluído

ax sessions show <session-id> --json
ax sessions show <session-id> --by-role
ax recall "specific keyword from the artifact" --sources=turn,commit --scope=here

Passo 4: Escrever a Reconstrução

Retorne o resultado inline, a menos que o usuário peça um arquivo. Mantenha-o curto e baseado em evidências:

1. Âncora: a data, commit, recurso ou artefato que você resolveu.
2. Fluxo de trabalho ordenado: 4-8 passos mostrando a habilidade ou ação e o que ela produziu.
3. Decisões chave: as escolhas do usuário ou agente que mudaram o caminho.
4. Verificação: testes, revisões, verificações ou evidências manuais.
5. Breve reprodutor: a receita compacta para fazer um trabalho semelhante novamente.

Use IDs de sessão, SHAs de commit e caminhos de arquivo como citações quando disponíveis.

Exemplos

Reconstruir um Recurso a partir de um Commit

ax sessions near 8f31c2a --json
ax sessions show <session-id> --by-role
ax sessions show <session-id> --json

Formato da saída:

Anchor: 8f31c2a, live ingest dashboard

Workflow:
1. Problem framing -> narrowed the failure to stale dashboard polling.
2. Session recall -> found the earlier ingest-stream design and constraints.
3. Implementation -> wired the server event bus and browser subscription.
4. Verification -> ran typecheck and refreshed the dashboard locally.

Reproducer brief:
Start from the failing artifact, find nearby sessions, inspect role-grouped
skills, then summarize the smallest ordered path from framing to verification.

Reconstruir Trabalho em Torno de uma Data

ax sessions around 2026-06-15 --days=2 --json
ax recall "otel receiver" --sources=turn,commit,skill --scope=here

Use isso quando o usuário se lembrar de quando o trabalho aconteceu, mas não do commit.

Melhores Práticas

• Comece pela âncora mais concreta disponível: SHA é melhor que data, data é melhor que tópico vago.
• Trate o ax como a fonte da verdade; não invente habilidades, custos, comandos ou decisões ausentes.
• Cite com moderação e apenas quando uma decisão ou comando do usuário for importante para a reconstrução.
• Mantenha os detalhes privados da transcrição privados; resuma em vez de despejar logs.
• Separe "o que aconteceu" de "o que repetir da próxima vez."

Limitações

• Requer uma instalação local do ax funcionando e um banco de dados local do ax alcançável.

…