agentkitco/agentkit-dev-skills

Auditar un archivo de instrucciones para el agente

Objetivo: encontrar líneas en un archivo de instrucciones que sean incorrectas, obsoletas, vagas o riesgosas, y proponer una versión más corta y precisa. Nunca "arregles" un comando que no hayas ejecutado ni una ruta que no hayas verificado.

Pasos

1. Encuentra los archivos. Busca AGENTS.md, CLAUDE.md, CLAUDE.local.md, .claude/rules/*.md, .cursor/rules/*.mdc, .cursorrules, .github/copilot-instructions.md y .github/instructions/*.md. Enumera lo que encontraste y quién lee cada archivo.
2. Ejecuta el verificador desde la raíz del repositorio para obtener primero los hallazgos mecánicos: python3 scripts/audit_instructions.py <archivo> [<archivo> ...] (La ruta es relativa a la carpeta de esta skill; usa la ruta completa a la skill instalada.) Reporta longitud, rutas de archivo rotas, comandos que nombran un script o destino make que no existe, frases vagas, marcadores de posición [BRACKET] sobrantes, líneas duplicadas y cadenas con apariencia de secreto. Si Python no está disponible, realiza las mismas verificaciones manualmente.
3. Verifica cada comando tú mismo. Para cada comando en el archivo, confirma que exista (script en package.json, destino en Makefile, entrada en pyproject.toml). Ejecuta los baratos y seguros (lint, pruebas unitarias, verificación de tipos). No ejecutes comandos de despliegue, migración o eliminación; márcalos como "no verificados".
4. Verifica los juicios subjetivos que el script no puede hacer:
   • Reglas que un linter o formateador ya aplica (candidatas a eliminar).
   • Reglas que se contradicen entre sí, o que contradicen otro archivo de instrucciones.
   • Hechos que el agente puede leer del repositorio en segundos (nombre del framework, listado de carpetas).
   • Reglas sin significado comprobable ("escribe código limpio").
   • Cualquier cosa que pertenezca a una regla con ámbito de ruta en lugar del archivo raíz.
5. Informa y luego espera la aprobación antes de editar.

Formato del informe

## Auditoría de archivo de instrucciones: <archivo>
Longitud: <n> líneas (<veredicto>)

### Debe corregirse (incorrecto o inseguro)
- línea <n>: <qué está mal>, <evidencia: salida del comando o ruta faltante>

### Debe recortarse (bajo valor)
- línea <n>: <por qué puede eliminarse>

### Contradicciones
- <archivo A línea n> vs <archivo B línea m>: <el conflicto>

### No verificado
- <comando>: <por qué no lo ejecutaste>

### Versión propuesta
<el archivo más corto, o un diff>

Reglas

• Evidencia sobre opinión: cada "debe corregirse" cita salida o un archivo faltante.
• Mantén la voz del propietario y cualquier regla que codifique un incidente real o una restricción dura.
• No agregues nuevas reglas durante una auditoría. Sugiérelas por separado al final, como máximo tres.
• Trata una cadena con apariencia de secreto como real: dile al usuario que la rote y no repitas el valor en tu informe.