observe-guidance
关于
This skill coaches users through systematic observation of systems or phenomena, emphasizing neutral attention, field notes, and pattern recognition. It's designed for debugging, research, or process analysis, guiding users to understand system behavior before intervening. Use it when someone needs to avoid jumping to conclusions and instead build evidence through disciplined observation.
快速安装
Claude Code
推荐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-guidance在 Claude Code 中复制并粘贴此命令以安装该技能
技能文档
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
GitHub 仓库
相关推荐技能
executing-plans
设计该Skill用于当开发者提供完整实施计划时,以受控批次方式执行代码实现。它会先审阅计划并提出疑问,然后分批次执行任务(默认每批3个任务),并在批次间暂停等待审查。关键特性包括分批次执行、内置检查点和架构师审查机制,确保复杂系统实现的可控性。
requesting-code-review
设计该Skill可在完成任务、实现主要功能或合并代码前自动调度代码审查子代理,确保实现符合需求和计划。它支持通过指定git SHA范围进行精准的代码变更审查,帮助开发者在关键节点及时发现潜在问题。核心原则是"早审查、勤审查",适用于开发流程的各个关键阶段。
connect-mcp-server
设计这个Skill指导开发者如何将MCP服务器连接到Claude Code,支持HTTP、stdio和SSE三种传输协议。它涵盖了从安装配置到认证安全的完整流程,适用于集成GitHub、Notion、数据库等外部服务。当开发者需要添加集成、配置外部工具或提及MCP相关功能时,这个Skill能提供实用的操作指南。
web-cli-teleport
设计该Skill帮助开发者根据任务特性选择Claude Code的Web或CLI界面,并指导如何在两种环境间无缝迁移会话。它能分析任务复杂度、迭代需求等要素,推荐最优工作界面和工作流。关键特性包括会话状态管理、环境切换指导和上下文优化建议。
