Mejorar
Rutas: ${CLAUDE_SKILL_DIR} significa la carpeta que contiene este SKILL.md, y ${CLAUDE_SKILL_DIR}/../.. la carpeta .claude/ del editor dos niveles arriba.
Cada pregunta al usuario va en el cuadro de preguntas: llama a la herramienta AskUserQuestion (2-4 opciones, la recomendada primero). Solo en un agente sin esa herramienta, haz preguntas numeradas en texto.
Esto se ejecuta en un checkout del repositorio, para la persona que lo mantiene. Una corrección aquí llega a todos los usuarios en su próxima actualización. S="${CLAUDE_SKILL_DIR}/scripts". Ejecuta los scripts con python3 en Mac y Linux, py en Windows.
0. Quién está ejecutando esto
python3 "$S/improve.py" mode
maintainer: solo en un checkout del repositorio con AI_EDITOR_MAINTAINER=1: continúa al paso 1.
user: los archivos propios del editor se reemplazan en cada actualización, así que nunca los edites (ningún SKILL.md, referencia, script o PRINCIPLES.md). Recolecta y selecciona como se indica abajo, luego guarda cada elemento aceptado en la capa del usuario, que las actualizaciones nunca tocan (docs/customise.md en el repositorio): un ajuste con taste.py add ... --set; una regla de palabras con python3 "${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py" rule "<regla>"; un estilo de subtítulos como custom/captions/<nombre>.json más taste.py set captions.preset <nombre>; valores predeterminados de plantillas como custom/templates/<tipo>.json. Luego ofrece taste.py suggest para que los mantenedores puedan corregirlo para todos. Detente ahí.
1. Recolectar
python3 "$S/improve.py" collect [--edits D] [--no-gh]
Una línea por regla, las más repetidas primero: veces que apareció, de dónde (sugerencia, regresión de gusto, corrección prevista, nota de revisión, issue de GitHub), el propietario nombrado y hasta tres ejemplos. Una regla dicha por varios usuarios, o dicha de nuevo después de aplicada, aparece primero.
2. Seleccionar
Muestra el inicio de la cola y pregunta en el cuadro de preguntas cuál corregir ahora (selección múltiple, la más repetida primero, recomendada). Para cada una, también pregunta si no está claro: Cada usuario (Recomendado) / Solo los estilos de algunos creadores (pertenece a un campo de style.json, no a una regla) / No es una corrección (ciérrala).
3. Corregir cada una, en este orden
- La regla. Una línea en
${CLAUDE_SKILL_DIR}/../../PRINCIPLES.mdbajo el encabezado correcto, nombrando dónde se aplica, y la misma regla en el SKILL.md o referencia propietaria. General, nunca sobre un video: "Los zooms suavizan durante al menos 0.5 s", no "el zoom en 0:12 fue brusco". - La verificación. El código más pequeño que hace que la regla se cumpla sin que nadie la recuerde: un FALLO en una verificación (
check.py,quality.py,product.py check,ai_tells.py), un rechazo en el script que la rompería (gates.py), un valor predeterminado que no pueda producirla, o una línea entests/check_plugins.pypara una regla del repositorio. Preferir ajustar una verificación existente a añadir una nueva. - La prueba. Un assert en el
demo()de ese script (o entests/), construido a partir de un ejemplo sintético pequeño del fallo. Ejecútalo antes de la corrección y verifica que falla, luego después y verifica que pasa. Una regla que solo un agente pueda seguir (preguntando, explicando) recibe en su lugar un caso de evaluación enevals/:prompt.mdmás un calificadortool_usedollm. - El registro.
docs/feedback-matrix.md: la regla, dónde está escrita, qué la verifica, qué pruebas la cubren.
4. Ejecutar todo
python3 tests/check_plugins.py
python3 .claude/lib/ai_editor/okf.py check
Luego tests/demos.sh (demo de cada script), node tests/test_record.mjs, y cuando el renderizador esté configurado tests/smoke.py y tests/golden.py. Todo en verde antes de entregar. No confirmar; el mantenedor revisa el diff y confirma.
Si se trata de un issue de GitHub que ahora está corregido, ofrece comentar un resumen de una línea de la corrección y cerrarlo (gh issue close <n> --comment "..."), solo después de preguntar.
Nunca
- Nunca edites taste.md, taste.json, rules.json o suggestions.jsonl de un usuario: son suyos.
- Nunca pongas datos personales en el repositorio: sin nombres, handles, correos electrónicos, nombres de archivo o material de video del feedback. Escribe la regla general y un ejemplo sintético.
tests/check_plugins.pyfalla con nombres privados conocidos; lee cada ejemplo antes de incluirlo. - Nunca cierres el ciclo solo con una nota. Una regla sin verificación ni prueba no está completa.
Archivos
scripts/improve.py:mode,collect,demo. Solo lectura.${CLAUDE_SKILL_DIR}/../../lib/ai_editor/custom.py: la carpeta<librería>/custom/del usuario (el modo usuario escribe allí).${CLAUDE_SKILL_DIR}/../../skills/taste/scripts/taste.py: dondesuggesteissueescriben la parte del usuario.