Melhorar
Caminhos: ${CLAUDE_SKILL_DIR} significa a pasta que contém este SKILL.md, e ${CLAUDE_SKILL_DIR}/../.. é a pasta .claude/ do editor dois níveis acima.
Toda pergunta ao usuário vai na caixa de perguntas: chame a ferramenta AskUserQuestion (2-4 opções, a recomendada primeiro). Apenas em um agente sem essa ferramenta, faça perguntas numeradas em texto.
Isso é executado em um checkout do repositório, para a pessoa que o mantém. Uma correção aqui alcança todos os usuários na próxima atualização. S="${CLAUDE_SKILL_DIR}/scripts". Execute os scripts com python3 no Mac e Linux, py no Windows.
0. Quem está executando isso
python3 "$S/improve.py" mode
maintainer apenas em um checkout git do repositório com AI_EDITOR_MAINTAINER=1: vá para o passo 1.
user: os arquivos do próprio editor são substituídos a cada atualização, então nunca os edite (nenhum SKILL.md, referência, script ou PRINCIPLES.md). Colete e selecione como abaixo, depois salve cada item aceito na camada do próprio usuário, que as atualizações nunca tocam (docs/customise.md no repositório): uma configuração com taste.py add ... --set; uma regra de palavra com python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<rule>"; uma aparência de legenda como custom/captions/<name>.json mais taste.py set captions.preset <name>; padrões de template como custom/templates/<type>.json. Depois ofereça taste.py suggest para que os mantenedores possam corrigir para todos. Pare por aí.
1. Coletar
python3 "$S/improve.py" collect [--edits D] [--no-gh]
Uma regra por linha, as mais repetidas primeiro: vezes que apareceu, de onde (sugestão, regressão de taste, correção de preview, nota de revisão, issue do GitHub), o dono nomeado e até três exemplos. Uma regra dita por vários usuários, ou dita novamente depois de aplicada, vem primeiro.
2. Escolher
Mostre o topo da fila e pergunte na caixa de perguntas qual corrigir agora (seleção múltipla, a mais repetida primeiro, recomendada). Para cada uma, também pergunte quando não estiver claro: Todo usuário (Recomendado) / Apenas alguns estilos de criadores (pertence a um campo em style.json, não a uma regra) / Não é uma correção (feche-a).
3. Corrigir cada uma, nesta ordem
- A regra. Uma linha em
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.mdsob o cabeçalho correto, nomeando onde é imposta, e a mesma regra no SKILL.md ou referência dona. Geral, nunca sobre um único vídeo: "Zooms suavizam por pelo menos 0,5 s", não "o zoom em 0:12 estalou". - A imposição. O menor código que faz a regra valer sem que ninguém precise lembrar dela: uma FALHA em uma verificação (
check.py,quality.py,product.py check,ai_tells.py), uma recusa no script que a quebraria (gates.py), um padrão que não pode produzi-la, ou uma linha emtests/check_plugins.pypara uma regra do repositório. Prefira apertar uma verificação existente a adicionar uma nova. - O teste. Um assert no
demo()desse script (ou emtests/), construído a partir de um pequeno exemplo sintético da falha. Execute-o antes da correção e veja falhar, depois e veja passar. Uma regra que apenas um agente pode seguir (perguntando, explicando) ganha um caso de eval emevals/em vez disso:prompt.mdmais um avaliadortool_usedoullm. - O registro.
docs/feedback-matrix.md: a regra, onde está escrita, o que a impõe, quais testes a verificam.
4. Executar tudo
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
Depois tests/demos.sh (demo de cada script), node tests/test_record.mjs, e quando o renderizador estiver configurado tests/smoke.py e tests/golden.py. Tudo verde antes de entregar. Não faça commit; o mantenedor revisa o diff e faz o commit.
Em uma issue do GitHub que agora está corrigida, ofereça comentar um resumo de uma linha da correção e fechá-la (gh issue close <n> --comment "..."), apenas depois de perguntar.
Nunca
- Nunca edite o taste.md, taste.json, rules.json ou suggestions.jsonl de um usuário: são dele.
- Nunca coloque dados pessoais no repositório: nenhum nome, usuário, email, nome de arquivo ou filmagem do feedback. Escreva a regra geral e um exemplo sintético.
tests/check_plugins.pyfalha em nomes privados conhecidos; leia cada exemplo antes de inseri-lo. - Nunca feche o ciclo com apenas uma anotação. Uma regra sem imposição e sem teste não está pronta.
Arquivos
scripts/improve.py:mode,collect,demo. Apenas leitura.${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: a pasta<library>/custom/do usuário (modo usuário escreve lá).${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py: ondesuggesteissueescrevem o lado do usuário.