/video-ask
Orienta al usuario en una sola pantalla: dónde está, en qué estado están las cosas, qué escribir a continuación.
1. Leer el estado desde archivos, no desde la memoria
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
"$PVS_HOME/bin/pvs-py" "$PVS_HOME/skills/video-ask/scripts/status.py"
Pasa una carpeta como primer argumento cuando el usuario pregunta sobre una que no es la carpeta actual.
Agrega --json si necesitas los campos (rutas, versiones, etapas) para responder una pregunta precisa.
El script infiere la etapa de cada video a partir de los archivos que define docs/contracts.md, la etapa
más reciente alcanzada: brief sin firmar, firmado, fuentes obtenidas, verdad, especificaciones, voz, construido, renderizado, QA fallido,
QA aprobado, entregado. Un informe de QA solo cuenta cuando su sha256 coincide con el render más reciente, por lo que un
re-render posterior a QA se muestra como renderizado nuevamente. Confía en el script por encima de lo que una conversación anterior
haya dicho: un subagente puede haber cambiado archivos desde entonces.
2. Responder
Muestra la salida del script tal cual (ya es corta) y luego el siguiente comando en su propia línea. Si el usuario hizo una pregunta (el argumento), respóndela después del estado, usando estas fuentes en orden, y di qué archivo usaste:
$PVS_HOME/README.md(qué son los skills, la instalación, las entradas que necesita un producto)$PVS_HOME/docs/contracts.md(formatos de archivos, estructura de carpetas, líneas de comando)- El
SKILL.mddel skill sobre el que trata la pregunta, en$PVS_HOME/skills/ - El
kit/RULES.mddel producto para preguntas de "por qué existe esta regla"
Si la respuesta no está en esos archivos, dilo en lugar de adivinar.
3. Cosas a señalar cuando las veas
- Configuración no realizada: el siguiente comando es
/video-setup. Nada más funciona de forma fiable antes. - Clave de voz no establecida: el usuario la pega en el
.envdel banco de trabajo en su propio editor, nunca en el chat.voice.provider: sayfunciona sin una. Nunca leas.envpara comprobarlo: el script ya informa si está o no establecida. - En la raíz del banco de trabajo con productos: cada producto es su propio proyecto de Claude Code, con sus
propios skills y hooks. El usuario ejecuta
cd products/<slug> && claudepara trabajar en él. - Brief sin firmar: la compilación espera intencionadamente las dos firmas del revisor. En la producción de donde provienen estos skills, 9 de 26 versiones ocurrieron porque nadie había acordado qué características debía explicar un video. No sugieras editar los campos de firma para el revisor.
- QA fallido: señala
qa/REPORT.mdde ese video para ver las comprobaciones que fallaron.
No empieces a construir, arreglar o entregar desde aquí. Este skill solo informa; el usuario escribe el siguiente comando.