Scripts para Agentes
Instruções compartilhadas para agentes, habilidades e pequenos utilitários portáteis para os espaços de trabalho locais de Peter.
Este repositório é o local canônico para:
AGENTS.MD: regras rígidas compartilhadas para agentes estilo Codex/Claudeskills/: habilidades de fluxo de trabalho reutilizáveis, incluindo habilidades de propriedade do repositório expostas por symlinkscripts/: utilitários leves (sem dependências) usados entre projetoshooks/: barreiras locais, como validação de habilidades
Habilidades
Habilidades são a principal camada de roteamento. Cada skills/<nome>/SKILL.md possui front matter YAML:
---
name: nome-da-habilidade
description: "Frase de gatilho genérica e curta."
---
Regras:
- Mantenha as descrições curtas e genéricas; otimize para roteamento, não para documentação.
- Mantenha os corpos das habilidades concisos e operacionais.
- Prefira scripts auxiliares em
skills/<nome>/scripts/quando um fluxo de trabalho tiver comandos repetitivos. - Valide após edições:
scripts/validate-skills. - Coloque
descriptionentre aspas no front matter.
A descoberta global é construída por scripts/sync-skills (idempotente; execute em todo Mac após clonar ou adicionar habilidades):
- Codex varre diretórios aninhados, então recebe links de raiz inteira:
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills,~/.codex/skills/manager -> ~/Projects/manager/skills. - Claude Code carrega apenas
~/.claude/skills/<nome>/SKILL.md(exatamente um nível de profundidade; symlinks por entrada são seguidos, subpastas de categoria não são varridas — verificado na versão 2.1.197). Ele recebe um espelho de habilidade plana por skill cobrindo ambos os repositórios mais extras~/.codex/skills/<nome>locais da máquina. - Colisões de nome resolvem agent-scripts > manager > codex-local; o script imprime duplicatas ignoradas e remove links gerenciados quebrados/obsoletos.
Habilidades pessoais compartilhadas vivem como pastas reais em skills/. Habilidades compartilhadas públicas do OpenClaw vivem em ../agent-skills e são expostas aqui com symlinks relativos rastreados. Habilidades de propriedade do repositório permanecem canônicas em seu repositório e são expostas aqui da mesma forma, por exemplo:
skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl
Habilidades atuais de propriedade do repositório vinculadas simbolicamente incluem birdclaw, discrawl, gog, imsg, slacrawl, wacli e wacrawl.
Instruções para Agentes
Regras rígidas compartilhadas vivem em AGENTS.MD.
Configuração global (também mantida por scripts/sync-skills; Claude Code lê apenas CLAUDE.md, então ele vincula ao AGENTS.MD compartilhado):
~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
Repositórios downstream devem usar um AGENTS.MD do tipo ponteiro:
LEIA ~/Projects/agent-scripts/AGENTS.MD ANTES DE QUALQUER COISA (pule se ausente).
Regras específicas do repositório vão abaixo desse ponteiro. Não copie os blocos compartilhados para repositórios downstream.
Auxiliares
scripts/committer
- Prepara exatamente os arquivos listados. -Exige uma mensagem de commit não vazia.
- Executa validação de habilidades antes de commitar.
scripts/sync-skills
- Constrói o espelho de habilidades por máquina: links de raiz inteira para Codex, links planos por habilidade para Claude, ponteiros
AGENTS.MDcompartilhados. - Idempotente; imprime apenas alterações, remove links gerenciados quebrados/obsoletos, nunca sobrescreve arquivos reais.
scripts/validate-skills
- Verifica cada
skills/*/SKILL.md. - Verifica front matter YAML mais os campos obrigatórios
nameedescription. - Ative como um hook local com
git config core.hooksPath hooks.
scripts/docs-list.ts
- Percorre
docs/. - Exige front matter com
summaryeread_when. - Imprime resumos de onboarding para repositórios que o integram.
scripts/browser-tools.ts
- Utilitário independente para Chrome DevTools.
- Comandos comuns:
start --profile,nav <url>,eval '<js>',screenshot,console,network,search --content "<consulta>",content <url>,inspect,kill --all --force. - Compile um binário opcional com
bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools.
Sincronização
Trate este repositório como canônico para regras compartilhadas de agentes e scripts auxiliares portáteis.
Ao sincronizar repositórios downstream:
- Atualize este repositório primeiro.
- Garanta que cada repositório de destino comece com o
AGENTS.MDdo tipo ponteiro. - Preserve as regras locais do repositório abaixo do ponteiro.
- Copie alterações de auxiliares em ambas as direções apenas quando o auxiliar for destinado a permanecer byte-idêntico.
- Mantenha os scripts livres de dependências e portáteis; sem imports específicos de repositório ou aliases de caminho.
Para submódulos, repita a verificação do ponteiro dentro de cada sub-repositório, envie essas alterações e então atualize os SHAs dos submódulos no repositório pai.