observe-guidance
À propos
Cette compétence guide les utilisateurs dans l'observation systématique de systèmes ou de phénomènes, en mettant l'accent sur l'attention neutre, la prise de notes de terrain et la reconnaissance de motifs. Elle est conçue pour le débogage, la recherche ou l'analyse de processus, en guidant les utilisateurs à comprendre le comportement d'un système avant d'intervenir. Utilisez-la lorsqu'une personne doit éviter de tirer des conclusions hâtives et doit plutôt constituer des preuves par une observation disciplinée.
Installation rapide
Claude Code
Recommandénpx skills add pjt222/agent-almanac -a claude-code/plugin add https://github.com/pjt222/agent-almanacgit clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/observe-guidanceCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
Observe (Guidance)
Guiar a una persona en la observación sistemática de un sistema, fenómeno o patrón. La IA actúa como coach de estudio de campo — ayudando a enmarcar el objetivo de observación, preparar un protocolo, sostener la atención neutral, registrar hallazgos con notas de campo, analizar patrones y reportar observaciones con separación clara entre datos e interpretación.
Cuándo Usar
- Una persona quiere comprender el comportamiento de un sistema antes de intervenir (depuración por observación en lugar de prueba y error)
- Alguien está realizando investigación o recopilando evidencia y necesita metodología de observación estructurada
- Una persona sigue saltando a conclusiones y necesita desarrollar la disciplina de observar antes de interpretar
- Alguien está preparando un informe que requiere hallazgos basados en evidencia, no opiniones
- Una persona quiere comprender dinámicas de equipo, comportamiento de usuarios o efectividad de procesos mediante observación directa
- Después de que
meditate-guidanceha cultivado atención sostenida, la persona quiere dirigir esa atención hacia un sistema específico
Entradas
- Requerido: Lo que la persona quiere observar (un sistema, proceso, comportamiento, base de código, dinámica de equipo, fenómeno natural)
- Requerido: Por qué están observando (depuración, investigación, auditoría, curiosidad, mejora)
- Opcional: Tiempo disponible para la observación (sesión única vs. estudio de varios días)
- Opcional: Intentos previos de comprender el sistema (qué se ha intentado ya)
- Opcional: Preguntas o hipótesis específicas que quieren probar
- Opcional: Herramientas disponibles para registro (cuaderno, captura de pantalla, logging, métricas)
Procedimiento
Paso 1: Enmarcar — Definir el objetivo de observación
Ayudar a la persona a establecer un marco de observación claro y delimitado.
- Preguntar qué quieren observar: "¿Qué sistema o comportamiento intentas comprender?"
- Ayudarles a reducir el alcance: "¿Qué aspecto específico de ese sistema te interesa más?"
- Identificar el propósito de la observación: comprensión, depuración, mejora, recopilación de evidencia o pura curiosidad
- Establecer límites: qué está dentro del alcance y qué no (previene que la observación se expanda sin fin)
- Si tienen una hipótesis: declararla explícitamente, luego apartarla — "Buscaremos evidencia tanto a favor como en contra"
- Elegir la postura de observación:
- Naturalista: observar sin interferir (mejor para comprender comportamiento)
- Controlada: cambiar una variable y observar el efecto (mejor para depuración)
- Longitudinal: observar a lo largo del tiempo (mejor para detectar tendencias)
Esperado: Un marco de observación claro con objetivo, alcance, propósito y postura definidos. La persona sabe qué está mirando y qué no está mirando.
En caso de fallo: Si la persona no puede reducir su enfoque ("Quiero entender todo"), ayudarles a elegir un punto de entrada: "¿Cuál es el comportamiento que más te confunde?" Si ya están comprometidos con una conclusión ("Solo necesito probar X"), desafiar gentilmente: "¿Qué necesitaríamos ver para refutar eso? Busquemos ambas cosas."
Paso 2: Preparar — Establecer el protocolo de observación
Ayudar a la persona a establecer un enfoque sistemático para registrar lo que observan.
- Elegir el método de registro basándose en el tipo de observación:
- Base de código/sistema: rutas de archivos, números de línea, marcas de tiempo, entradas de log
- Comportamiento/proceso: notas con marca de tiempo con actor, acción y contexto
- Equipo/comunicación: citas, identificadores de hablantes, señales no verbales
- Natural/físico: bocetos, mediciones, condiciones ambientales
- Crear una plantilla de registro simple:
Field Notes Template:
┌─────────────┬────────────────────────────────────────────────────────┐
│ Timestamp │ When the observation occurred │
├─────────────┼────────────────────────────────────────────────────────┤
│ Observation │ What was seen/heard/measured (fact only) │
├─────────────┼────────────────────────────────────────────────────────┤
│ Context │ What was happening around the observation │
├─────────────┼────────────────────────────────────────────────────────┤
│ Reaction │ Observer's response (thoughts, emotions, surprises) │
├─────────────┼────────────────────────────────────────────────────────┤
│ Hypothesis │ Tentative interpretation (kept separate from fact) │
└─────────────┴────────────────────────────────────────────────────────┘
- Enfatizar la separación: "La fila de observación es un hecho. La fila de hipótesis es interpretación. Nunca mezclarlas."
- Establecer un conteo mínimo de observaciones: "Apunta a al menos 10 observaciones antes de sacar cualquier conclusión"
- Si aplica, configurar herramientas de monitoreo: logging, métricas, grabación de pantalla
Esperado: La persona tiene un método de registro listo y comprende la distinción crítica entre observación e interpretación. Se sienten preparados para comenzar.
En caso de fallo: Si la plantilla se siente demasiado formal, simplificar a: "Solo escribe lo que ves, y por separado escribe lo que crees que significa." Si se resisten a registrar ("Lo recordaré"), explicar que las observaciones no registradas están sujetas a sesgo de memoria — el acto de escribir hace la observación más precisa.
Paso 3: Observar — Practicar la atención neutral sostenida
Guiar a la persona a través de la sesión de observación real.
- Recordarles la postura: "Eres un naturalista estudiando una nueva especie. No interfieras — solo observa"
- Durante los primeros 5 minutos: fomentar la observación pura sin registro — solo atender
- Después de la inmersión inicial: comenzar a registrar usando la plantilla
- Guiar hacia un lenguaje neutral: "En lugar de 'el sistema se cayó,' intenta 'el sistema dejó de responder a las 14:32 después de procesar la solicitud número 47'"
- Vigilar que la interpretación se infiltre en la observación: "Eso es una interpretación — regístralo en la fila de hipótesis"
- Fomentar notar las sorpresas: "¿Qué te sorprendió? Las sorpresas a menudo contienen los datos más valiosos"
- Verificar periódicamente el marco: "¿Sigues observando lo que te propusiste observar, o tu atención se ha desviado?"
- Si quieren intervenir: "Nota lo que quieres cambiar y por qué, pero no lo cambies todavía — sigue observando"
Esperado: La persona genera al menos 5-10 observaciones concretas con evidencia específica. Experimentan la diferencia entre observar e interpretar, y descubren que es más difícil de lo esperado mantener la atención neutral.
En caso de fallo: Si siguen interpretando en lugar de observar, probar este ejercicio: "Describe lo que ves como si se lo explicaras a alguien que nunca ha visto este sistema. Usa solo hechos verificables." Si se les acaban las cosas para observar rápidamente, están mirando a un nivel demasiado alto — guiarlos para acercarse a los detalles: temporización, orden, casos límite, excepciones.
Paso 4: Registrar — Capturar hallazgos con notas de campo
Ayudar a la persona a organizar sus observaciones crudas en notas estructuradas.
- Revisar juntos las observaciones registradas
- Verificar la completitud: ¿cada observación tiene suficiente contexto para ser comprendida después?
- Verificar la precisión factual: ¿las declaraciones son verificables, o contienen suposiciones ocultas?
- Agrupar observaciones similares: "¿Ves algún patrón formándose?"
- Notar frecuencias: ¿con qué frecuencia apareció cada patrón?
- Notar ausencias: "¿Qué esperabas ver que no estuvo ahí?"
- Ayudarles a separar observaciones fuertes (evidencia clara) de observaciones débiles (datos ambiguos)
Esperado: Un conjunto de notas de campo organizadas que separan limpiamente la observación de la interpretación. Las notas son lo suficientemente detalladas para que otra persona pudiera verificar las observaciones independientemente.
En caso de fallo: Si las notas son demasiado vagas ("las cosas parecían lentas"), ayudarles a agregar específicos: "¿Qué tan lento? ¿Comparado con qué? ¿En qué condiciones?" Si las notas son demasiado detalladas (registrando todo), ayudarles a identificar qué observaciones se relacionan con el marco original y cuáles son ruido.
Paso 5: Analizar — Identificar patrones y generar hipótesis
Guiar a la persona desde las observaciones hacia el análisis estructurado.
- Disponer todas las observaciones y buscar patrones:
- Repetición: "Esto sucedió múltiples veces — ¿es sistemático?"
- Correlación: "X siempre sucede junto con Y — ¿están relacionados?"
- Secuencia: "A siempre precede a B — ¿podría A causar B?"
- Ausencia: "X nunca sucede en la condición Z — ¿por qué?"
- Anomalía: "Todo sigue el patrón P excepto este caso — ¿qué es diferente?"
- Para cada patrón, preguntar: "¿Hay una explicación alternativa?"
- Generar 2-3 hipótesis que expliquen los patrones principales
- Distinguir entre correlación y causalidad: "Observar que A y B co-ocurren no prueba que A cause B"
- Identificar qué hipótesis son verificables y qué prueba las confirmaría/refutaría
- Notar niveles de confianza: ¿qué hipótesis están bien respaldadas, cuáles son especulativas?
Esperado: La persona pasa de observaciones crudas a hipótesis estructuradas manteniendo la disciplina de separar datos de teoría. Tienen al menos una hipótesis verificable para su pregunta original.
En caso de fallo: Si saltan a una sola explicación inmediatamente, desafiarla: "Esa es una posibilidad. ¿Cuál es otra?" Si no ven patrones, las observaciones pueden ser muy pocas — sugerir continuar la observación antes del análisis. Si cada observación parece apuntar a la misma conclusión, pueden estar filtrando — preguntar: "¿Qué evidencia contradiría tu teoría actual?"
Paso 6: Reportar — Compartir hallazgos con estructura clara
Ayudar a la persona a comunicar sus observaciones efectivamente.
- Estructurar el informe:
- Contexto: Qué se observó, cuándo, por qué, bajo qué condiciones
- Método: Cómo se condujo la observación (protocolo, herramientas, duración)
- Hallazgos: Observaciones clave con evidencia (datos, no interpretación)
- Análisis: Patrones identificados, hipótesis generadas, niveles de confianza
- Recomendaciones: Próximos pasos sugeridos (más observación, pruebas, intervención)
- Limitaciones: Lo que la observación no cubrió, sesgos potenciales
- Ayudarles a escribir hallazgos en lenguaje neutral que separe hechos de interpretación
- Revisar en busca de suposiciones ocultas o afirmaciones no respaldadas
- Si las observaciones son para depuración: traducir hipótesis en pruebas concretas
- Si las observaciones son para un informe: asegurar que la evidencia se cite específicamente
- Si las observaciones son para comprensión personal: resumir las percepciones clave y las preguntas restantes
Esperado: Un informe claro que comunica observaciones, patrones e hipótesis manteniendo la distinción entre lo que se observó y lo que se infirió. El lector puede evaluar la evidencia independientemente.
En caso de fallo: Si el informe entierra las observaciones en interpretación, reestructurar: "Pon todos los hechos en una sección, todas las teorías en otra." Si el informe carece de niveles de confianza ("esto es definitivamente porque..."), ayudarles a calibrar: "¿Qué tan seguro estás? ¿Qué cambiaría tu opinión?"
Validación
- El objetivo de observación fue enmarcado antes de que comenzara la observación (no exploración sin forma)
- Un protocolo de registro fue establecido y usado consistentemente
- Las observaciones fueron registradas como hechos, separadas de las interpretaciones
- Al menos 5 observaciones concretas respaldadas por evidencia fueron capturadas
- Los patrones fueron identificados mediante análisis, no asumidos desde el inicio
- Las hipótesis son verificables y tienen niveles de confianza declarados
- La persona experimentó la disciplina de observar antes de interpretar
Errores Comunes
- Observación como sesgo de confirmación: Observar solo cosas que apoyan una creencia preexistente. El marco debe incluir "buscar evidencia contra tu hipótesis" como instrucción explícita
- Impulso de intervención: Ver un problema y querer arreglarlo inmediatamente. La intervención prematura a menudo enmascara la causa raíz — observar primero, luego intervenir con comprensión completa
- Fatiga de registro: La observación detallada es mentalmente exigente. Sugerir descansos y duraciones realistas de sesión (30-60 minutos de observación enfocada es sustancial)
- Sobrecomplicar el protocolo: Para observaciones simples, un cuaderno y marcas de tiempo son suficientes. El protocolo debe servir a la observación, no reemplazarla
- Confundir observación con vigilancia: En la observación interpersonal, los límites éticos importan. Observar comportamiento visible, no espiar. Si se observan personas, la transparencia suele ser mejor que el secreto
- Omitir el marco: Sin un objetivo de observación claro, la atención se dispersa y los hallazgos quedan desenfocados. Incluso un marco aproximado es mejor que ninguno
Habilidades Relacionadas
observe— la variante autodirigida de la IA para reconocimiento neutral sostenido de patrones en sistemaslearn-guidance— la observación alimenta el aprendizaje proporcionando datos crudos para la comprensiónlisten-guidance— escuchar es observación enfocada de un hablante; la observación es atención de alcance más amplio hacia cualquier sistemaremote-viewing-guidance— comparte metodología de observación estructurada adaptada para percepción no localread-garden— habilidad de observación de jardín que usa protocolos sensoriales similares adaptados de CRV
Dépôt GitHub
Compétences associées
executing-plans
DesignUtilisez la compétence executing-plans lorsque vous disposez d'un plan de mise en œuvre complet à exécuter par lots contrôlés avec des points de contrôle de revue. Elle charge et examine le plan de manière critique, puis exécute les tâches par petits lots (3 tâches par défaut) tout en rapportant la progression entre chaque lot pour une revue par l'architecte. Cela garantit une mise en œuvre systématique avec des points de contrôle de qualité intégrés.
requesting-code-review
DesignCette compétence délègue un sous-agent réviseur de code pour analyser les modifications apportées au code par rapport aux exigences avant de poursuivre. Elle doit être utilisée après avoir terminé des tâches, implémenté des fonctionnalités majeures, ou avant une fusion vers la branche principale. La revue aide à détecter précocement les problèmes en comparant l'implémentation actuelle avec le plan initial.
connect-mcp-server
DesignCette compétence fournit un guide complet permettant aux développeurs de connecter des serveurs MCP à Claude Code via les transports HTTP, stdio ou SSE. Elle couvre l'installation, la configuration, l'authentification et la sécurité pour intégrer des services externes tels que GitHub, Notion et des API personnalisées. Utilisez-la lors de la configuration d'intégrations MCP, de la configuration d'outils externes ou du travail avec le Protocole de Contexte de Modèle de Claude.
web-cli-teleport
DesignCette compétence aide les développeurs à choisir entre les interfaces Web et CLI de Claude Code en fonction de l'analyse des tâches, puis permet une téléportation transparente des sessions entre ces environnements. Elle optimise le flux de travail en gérant l'état et le contexte de la session lors du passage entre le web, la CLI ou le mobile. Utilisez-la pour des projets complexes nécessitant différents outils à diverses étapes.
