mrcha033/skills

Revisión de Asesor

Usa los scripts incluidos de este directorio de habilidad. Una invocación explícita es un pestillo: ejecuta el revisor en la misma tarea padre antes de una respuesta final sustantiva o una acción que siga o entre en conflicto con la revisión. La recopilación de evidencia de solo lectura puede continuar mientras se construye el paquete.

No busques en el catálogo global de herramientas un asesor. No abras una segunda tarea visible para el usuario. La única ejecución hija es el proceso aislado codex exec iniciado por scripts/run_advisor.py.

Requisitos

Requiere ejecución de shell, un CLI codex local autenticado, acceso a la ruta del modelo gpt-5.6-sol solicitado y acceso a la API de Codex saliente desde el shell padre. Un sandbox padre que bloquee la red de subprocesos también bloquea el revisor anidado. Si falta algún requisito, informa que la revisión independiente está bloqueada; no debilites el sandbox sin autorización del usuario o de la tarea.

El ejecutor no es un límite de confidencialidad. Sanitiza la evidencia y los artefactos antes de construir el paquete.

Flujo de trabajo

1. Anuncia que se está usando la Revisión de Asesor y por qué.

2. Selecciona una fase:

   • plan: desafía un enfoque propuesto.
   • atascado: diagnostica trabajo fallido o en bucle.
   • pivotar: compara un enfoque materialmente diferente.
   • final: audita el trabajo completado y su evidencia de punto final.

3. Lee references/context-contract.md.

4. Elige el modo de contexto:

   • paquete: los hechos cortos anclados a la fuente son suficientes.
   • lote: los registros sanitizados, líneas de tiempo, diferencias u otros artefactos de texto acotados afectan materialmente el diagnóstico.

5. Construye advisor-context-2.0 con scripts/build_context_packet.py.

   • Para atascado, incluye acciones y resultados exactos en orden cronológico.
   • Dale a cada hecho observado una fuente concreta.
   • Incluye resultados negativos, estado conflictivo y limitaciones de contexto.
   • Nunca trunques silenciosamente texto crítico para la decisión. Un fallo del constructor es una revisión bloqueada.

6. Lee references/review-rubric.md.

7. Selecciona el esfuerzo:

   1. Honra una solicitud explícita de alto, muy_alto o máximo.
   2. Usa máximo solo para una revisión más profunda explícitamente solicitada o una decisión crítica y difícil de revertir con ambigüedad mayor no resuelta.
   3. Usa muy_alto para fallos entre componentes, evidencia verificada conflictiva, dos o más enfoques fallidos, pivotes importantes o afirmaciones de finalización de alto impacto.
   4. En caso contrario, usa alto.

8. Ejecuta exactamente una revisión aislada por defecto y guarda su recibo:

   python3 scripts/run_advisor.py \
     --input context-packet.json \
     --effort muy_alto \
     --output advisor-receipt.json
   

   Mantén el recibo devuelto en la tarea que invoca. Un recibo producido en otra tarea visible para el usuario no es una transferencia.

9. Verifica el recibo:

   • request.requested_model debe ser gpt-5.6-sol.
   • request.requested_effort debe coincidir con el esfuerzo seleccionado.
   • observed_model y observed_effort pueden ser null; el CLI actual no expone autoritativamente la identidad del lado del servidor. Nunca describas la identidad solicitada como identidad real verificada.
   • Cualquier error del ejecutor, fallo de esquema, tiempo de espera o discrepancia de hash de contexto bloquea la revisión.
   • El hijo aislado usa un CODEX_HOME temporal con solo el archivo de autenticación del host vinculado cuando está presente. También deshabilita plugins, carga remota de plugins, búsqueda de habilidades y ejecución multiagente, para que catálogos de habilidades no relacionados no puedan consumir el contexto de revisión.

10. Lee references/decision-contract.md. Resuelve cada recomendación R# como adoptar, rechazar o aplazar, luego ejecuta:

    python3 scripts/validate_decision.py \
      --receipt advisor-receipt.json \
      --decision advisor-decision.json
    

11. No actúes según las recomendaciones del asesor hasta que el registro de decisión se valide. Una recomendación destructiva requiere además autorización confirmada del usuario.

12. Continúa la tarea padre usando la siguiente acción validada y la condición de parada.

Reglas para trabajo atascado

• Diagnostica antes de cambiar más estado.
• Distingue el límite de ejecución: la tarea padre, el proceso revisor aislado y cualquier otra tarea visible para el usuario son separados.
• No permitas que el recibo de una tarea separada reemplace una transferencia en la misma tarea.
• Prefiere un experimento de solo lectura o reversible que separe hipótesis competidoras.
• Después de una corrección repetida del usuario, no repitas la misma prescripción sin nueva evidencia.
• No amplíes el alcance de un subsistema fallido a plugins, servicios, repositorios o paquetes a menos que la evidencia los conecte.

Presupuesto de revisión

Usa una revisión por defecto. Se permite una segunda solo cuando nueva evidencia cambia materialmente la decisión o se justifica una nueva verificación final de alto riesgo. Se permite una tercera solo para reconciliar un conflicto concreto. Nunca crees un bucle de revisión abierto.

Puerta de cambio de comportamiento de la habilidad

Al modificar la Revisión de Asesor, ejecuta las pruebas deterministas y al menos un fixture de comportamiento sanitizado:

python3 scripts/evaluate_advisor_behavior.py \
  --fixture behavior-fixture.json \
  --receipt advisor-receipt.json

Usa fixtures emparejados viejos/nuevos cuando sea práctico. Evalúa detección, vinculación de evidencia, experimentos acotados y tasa de acciones arriesgadas, no la similitud de prosa.

Informe

Informa:

• fase, modo de contexto, modelo Sol solicitado, esfuerzo solicitado y estado de verificación de identidad;
• veredicto del asesor y diagnóstico vinculado a evidencia;
• disposición adoptar/rechazar/aplazar de cada recomendación consecuencial;
• la siguiente acción seleccionada y la condición de parada;
• riesgos no resueltos o limitaciones de contexto.

Llama al resultado una revisión independiente estilo asesor, no paridad con Claude Advisor.