Pular para o conteúdo
Skillpedia
Testes48 mil · #4640

atlas-ledger

Faz seu agente registrar erros ou mudanças em projetos. Ele anota o que deu errado e como corrigir. É útil para manter um histórico de correções e melhorias.

O que ela faz

Esta ferramenta cria regras para evitar que erros se repitam em um projeto. Ela transforma um erro detectado em uma instrução clara (uma 'cláusula') que pode ser usada em projetos futuros para impedir que o mesmo erro aconteça novamente.

Quando usar

  • ✓Quando um erro grave é detectado automaticamente durante uma revisão do projeto.
  • ✓Após o usuário indicar que um resultado do projeto está incorreto ou incompleto.
  • ✓Quando o usuário pede explicitamente para registrar um erro para evitar que ele se repita.

Exemplo do que pedir para a IA

“Registre este erro para que não aconteça de novo: o sistema deveria ter avisado sobre a falta de estoque, mas apenas mostrou uma mensagem genérica.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/skills/atlas-ledger/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/skills/atlas-ledger/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A ferramenta analisa o erro que aconteceu e o descreve como um fato objetivo. Em seguida, ela cria uma regra no formato 'QUANDO isso acontecer, NÃO faça aquilo, EM VEZ disso faça outra coisa'. Essa regra é salva para ser usada em projetos futuros.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill atlas-ledger

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/skills/atlas-ledger/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Atlas Ledger v2.2

Dê à série Atlas uma memória.

Conteúdo

  1. Idioma de Saída
  2. Quando Executar
  3. Destilação (o núcleo) — Passos 1–6
  4. Formato Atlas.md
  5. Manutenção de Cláusulas
  6. Integração com atlas-contract
  7. Princípio Final

Referência Rápida

caught drift (auto handoff from Final Audit / Post Review / Phase Check / user request)
 → Step 1  state facts, not motive
 → Step 2  draft WHEN / DON'T / INSTEAD
 → Step 3  four gates: Actionability → Replay → Generalization → Over-reach
 → Step 4  first occurrence = Observation [O#]; repeat or high-severity = Clause [L#]
 → Step 5  propose, ATLAS_STOP, write only after user confirms
 → Step 6  merge-first into Atlas.md; confirmed clauses ≤ 15

atlas-contract defende o objetivo dentro de uma única conversa, mas começa do zero a cada vez — ele não sabe para onde este projeto derivou antes. atlas-ledger fecha essa lacuna: quando uma deriva é detectada, ela destila a lição em uma cláusula de contrato permanente e local do projeto e (após a confirmação do usuário) a escreve em Atlas.md. Na próxima vez que atlas-contract construir um Contrato de Objetivo, ele carrega as cláusulas relevantes, então a linha de defesa engrossa a cada captura. Esse é o efeito de composição.

É um companheiro de baixa frequência e leve. Ele executa apenas após uma deriva ser detectada, e permanece pequeno de propósito. Não o transforme em uma segunda habilidade de governança pesada — seu único trabalho difícil é a qualidade da destilação.

Ideia Central

O trabalho não é manter um diário. Um registro de "o que deu errado" é uma memória; não muda nada. O trabalho é uma tradução:

transformar esta deriva detectada → em uma cláusula que pode entrar em um contrato futuro e acionar uma parada.

Um diário diz "Eu escondi o recurso." Uma cláusula de ledger diz "QUANDO um requisito de backend for bloqueado, NÃO esconda o recurso, EM VEZ disso, pare e divulgue." Apenas o segundo pega da próxima vez. Todo o valor desta habilidade é a qualidade dessa tradução — e como ela é executada pelo mesmo modelo que derivou, os mecanismos abaixo existem para mantê-lo honesto em vez de confiar nele para ser cuidadoso.


1. Idioma de Saída

Escreva Atlas.md e toda a saída voltada para o usuário no idioma da instrução atual do usuário.

Chaves de máquina permanecem em inglês; o conteúdo da cláusula é localizado. Nunca traduza as chaves WHEN / DON'T / INSTEAD, os IDs (L1, O1), seen, severity, Source, RETIRED, ou cabeçalhos de seção Confirmed Clauses / Provisional Observations — atlas-contract os analisa, e traduzi-los torna a leitura instável. O texto após cada chave é escrito no idioma do usuário. (Ex: WHEN: 硬性 Must-Do 的后端部分受阻 — chave em inglês, conteúdo em chinês. Não escreva 当: ....)

Todo rótulo de processo que esta habilidade emite ao usuário também deve ser localizado (estes não são chaves de máquina — são cabeçalhos mostrados ao usuário, como os quatro nomes de portão ou o cabeçalho da cláusula candidata). Apenas as chaves fixas de máquina acima permanecem em inglês.

Mapeamento de rótulos em chinês (rótulos de processo — localize estes):

  • Atlas Event → Atlas 事件; Event ID → 事件编号; Type → 类型; Trigger Source → 触发来源; Phase → 阶段; Stop Status → 停止状态
  • Candidate Clause / Suggested Clause → 候选条款; Proposal → 提案; awaiting confirmation → 等待确认
  • Four acceptance gates → 四道闸自检; Actionability → 可执行性; Replay → 回放; Generalization → 泛化; Over-reach → 误伤; Pass → 通过; Fail → 失败
  • confirmed on first occurrence → 首次出现即确认; merged → 已合并; retired → 已退休; review: stale → 待复核:可能失效

Auto-verificação de localização pré-saída: Antes de enviar qualquer saída voltada para o usuário, verifique se há rótulos de processo em inglês não traduzidos (ex: "Suggested Clause", "Actionability"). Se algum for encontrado, traduza-os antes de enviar. Não traduza as chaves fixas de máquina (WHEN/DON'T/INSTEAD/IDs/severity/Source/seen/Confirmed Clauses/Provisional Observations) — estas permanecem em inglês mesmo em uma resposta em chinês.


Quando Usar

2. Quando Executar

Execute a destilação apenas quando uma deriva for detectada. Gatilhos, na ordem em que geralmente chegam:

…

Perguntas frequentes

O que é uma 'cláusula'?

É uma instrução curta e clara, como uma regra, que diz o que fazer ou não fazer em uma situação específica para evitar um erro. Por exemplo: 'QUANDO o estoque estiver baixo, NÃO esconda a mensagem, EM VEZ DISSO, mostre um aviso claro'.

Onde essas regras são salvas?

As regras confirmadas são salvas em um arquivo chamado Atlas.md, que funciona como uma memória do projeto. Isso garante que as lições aprendidas com os erros sejam usadas em trabalhos futuros.

A ferramenta pode registrar qualquer tipo de problema?

Não, ela só registra 'desvios' ou erros que foram detectados. Ela não serve para registrar opiniões, preferências de estilo ou resumos gerais. O foco é em problemas que podem ser transformados em regras claras.

Detalhes

Descrição original do autor

Companion to atlas-contract. Auto-invoked by its Final Audit on caught drift; also use after Post Reviews or user requests to record a mistake. Distills drift into WHEN/DON'T/INSTEAD clauses, writes to Atlas.md after confirmation.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#4640
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas