observe
について
`observe`スキルは、自然主義的な野外調査をモデルとした、介入を伴わない構造化された中立的なパターン認識手法を提供します。これは、未知の根本原因のデバッグ、コード変更の評価、または即時のアクションが時期尚早な際の推論パターンの監査といった状況を想定して設計されています。主な機能には、持続的な注意、パターンの記録、発見の分類、再利用可能な観察ライブラリの構築が含まれます。
クイックインストール
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このコマンドをClaude Codeにコピー&ペーストしてスキルをインストールします
ドキュメント
Observe
Conducir una sesión de observación estructurada — enmarcar el objetivo de observación, presenciar con atención neutral sostenida, registrar patrones sin interpretación, categorizar hallazgos, generar hipótesis a partir de patrones y archivar las observaciones para referencia futura.
Cuándo Usar
- El comportamiento de un sistema no es claro y actuar sin observación sería prematuro
- Depurando un problema donde la causa es desconocida — observación antes de intervención previene enmascarar síntomas
- Una base de código o sistema ha sido cambiado y los efectos necesitan ser presenciados antes de hacer más cambios
- Entender patrones de comportamiento del usuario a lo largo de una conversación para mejorar interacciones futuras
- Auditar los propios patrones de razonamiento por sesgos, hábitos o errores recurrentes
- Después de que
learnha construido un modelo que necesita validación mediante observación del sistema en acción
Entradas
- Requerido: Objetivo de observación — un sistema, base de código, patrón de comportamiento, interacción de usuario o proceso de razonamiento a observar
- Opcional: Duración/alcance de observación — cuánto tiempo o profundidad observar antes de concluir
- Opcional: Pregunta o hipótesis específica para guiar el enfoque de la observación
- Opcional: Observaciones previas para comparar (detectar cambio a lo largo del tiempo)
Procedimiento
Paso 1: Enmarcar — Establecer el enfoque de observación
Definir qué se está observando, por qué y desde qué perspectiva.
Observation Protocol by System Type:
┌──────────────────┬──────────────────────────┬──────────────────────────┐
│ System Type │ What to Observe │ Categories to Watch │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Codebase │ File structure, naming │ Patterns, anti-patterns, │
│ │ conventions, dependency │ consistency, dead code, │
│ │ flow, test coverage, │ documentation quality, │
│ │ error handling patterns │ coupling between modules │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ User behavior │ Question patterns, │ Expertise signals, pain │
│ │ vocabulary evolution, │ points, unstated needs, │
│ │ repeated requests, │ learning trajectory, │
│ │ emotional signals │ communication style │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Tool / API │ Response patterns, error │ Rate limits, edge cases, │
│ │ conditions, latency, │ undocumented behavior, │
│ │ output format variations │ state dependencies │
├──────────────────┼──────────────────────────┼──────────────────────────┤
│ Own reasoning │ Decision patterns, tool │ Biases, habits, blind │
│ │ selection habits, error │ spots, strengths, │
│ │ recovery approaches, │ recurring failure modes, │
│ │ communication patterns │ over/under-confidence │
└──────────────────┴──────────────────────────┴──────────────────────────┘
- Seleccionar el objetivo de observación y nombrarlo explícitamente
- Definir el límite de observación: qué está incluido y qué está fuera de alcance
- Declarar la postura de observación: "Estoy observando, no interviniendo"
- Si hay una pregunta guía, declararla — pero mantenerla ligeramente; estar dispuesto a notar cosas fuera del alcance de la pregunta
- Elegir las categorías apropiadas de la matriz anterior
Esperado: Un marco claro que dirige la atención sin constreñirla. El observador sabe dónde mirar y en qué categorías clasificar las observaciones, pero permanece abierto a lo inesperado.
En caso de fallo: Si el objetivo de observación es demasiado amplio ("observar todo"), reducir a un subsistema o un patrón de comportamiento. Si el objetivo es demasiado estrecho ("observar esta variable"), ampliar al contexto circundante — los patrones interesantes a menudo están en los bordes.
Paso 2: Presenciar — Atención neutral sostenida
Mantener la atención en el objetivo de observación sin interpretar, juzgar ni intervenir.
- Comenzar la observación sistemática: leer archivos, rastrear rutas de ejecución, revisar historial de conversación — lo que el objetivo requiera
- Registrar lo que se ve, no lo que significa — descripción antes de interpretación
- Resistir el impulso de arreglar problemas encontrados durante la observación — notarlos y continuar
- Resistir el impulso de explicar patrones antes de que suficientes observaciones se acumulen
- Si la atención se desvía hacia un objetivo diferente, notar la desviación (puede ser significativa) y regresar al marco
- Mantener la observación por un período definido: al menos 3-5 puntos de datos distintos antes de pasar a categorización
Esperado: Una colección de observaciones crudas — específicas, concretas y libres de interpretación. Las observaciones se leen como notas de campo: "El archivo X importa Y pero no usa la función Z. El archivo A tiene 300 líneas; el archivo B tiene 30 líneas y cubre funcionalidad similar."
En caso de fallo: Si la observación inmediatamente dispara análisis ("esto está mal porque..."), el hábito analítico está anulando la postura observacional. Separar conscientemente las fases: escribir la observación como un hecho, luego escribir la interpretación como una nota separada etiquetada "hipótesis." Si la neutralidad es imposible (reacción fuerte a lo observado), notar la reacción misma como dato: "Noté preocupación fuerte al observar X — esto puede indicar un problema significativo o puede indicar mi sesgo."
Paso 3: Registrar — Capturar patrones crudos
Transcribir observaciones en un formato estructurado mientras están frescas.
- Listar cada observación como una declaración única de hecho (qué se vio, dónde, cuándo)
- Agrupar observaciones naturalmente similares — no forzar agrupación, pero notar cuando las observaciones se agrupan
- Notar frecuencia: ¿este patrón apareció una vez, ocasionalmente o de manera generalizada?
- Notar contrastes: ¿dónde se rompió el patrón? Las excepciones son a menudo más informativas que las reglas
- Notar patrones temporales: ¿la observación cambió con el tiempo, o fue estática?
- Capturar evidencia exacta: rutas de archivos, números de línea, palabras específicas, ejemplos concretos
Esperado: Un registro estructurado de 5-15 observaciones discretas, cada una con evidencia específica. El registro debería ser lo suficientemente detallado para que otro observador pudiera verificar cada observación independientemente.
En caso de fallo: Si las observaciones son demasiado abstractas ("el código parece desordenado"), necesitan fundamentación en específicos — qué archivos, qué patrones, qué lo hace desordenado. Si las observaciones son demasiado granulares ("la línea 47 tiene un espacio antes de la llave"), ampliar al nivel de patrón — ¿es un caso aislado o un problema sistémico?
Paso 4: Categorizar — Organizar hallazgos
Clasificar observaciones en categorías significativas sin explicarlas todavía.
- Revisar todas las observaciones registradas y buscar agrupaciones naturales
- Asignar cada observación a una categoría de la matriz del Paso 1, o crear nuevas categorías si es necesario
- Dentro de cada categoría, clasificar observaciones por frecuencia y significancia
- Identificar qué categorías tienen muchas observaciones (áreas bien documentadas) y cuáles tienen pocas (potenciales puntos ciegos)
- Buscar patrones entre categorías: ¿el mismo patrón subyacente se manifiesta diferente en diferentes categorías?
- Notar cualquier observación que no encaje en ninguna categoría — los valores atípicos son a menudo los datos más interesantes
Esperado: Un mapa de observaciones categorizado con agrupaciones claras. Cada categoría tiene observaciones específicas respaldándola. El mapa muestra tanto patrones como brechas.
En caso de fallo: Si la categorización se siente forzada, las observaciones pueden no tener agrupaciones naturales — pueden ser una colección de hallazgos no relacionados, lo cual es en sí un hallazgo (el sistema puede carecer de estructura coherente). Si todo encaja limpiamente en una categoría, el alcance de observación fue demasiado estrecho — ampliar.
Paso 5: Teorizar — Generar hipótesis a partir de patrones
Ahora — y solo ahora — comenzar a interpretar las observaciones.
- Para cada patrón principal observado, proponer una hipótesis: "Este patrón existe porque..."
- Para cada hipótesis, identificar evidencia de respaldo desde las observaciones
- Para cada hipótesis, identificar qué contra-evidencia la refutaría
- Clasificar hipótesis por poder explicativo: ¿cuál explica la mayor cantidad de observaciones?
- Generar al menos una hipótesis contraria: "La explicación obvia es X, pero también podría ser Y porque..."
- Identificar qué hipótesis son verificables y cuáles son especulativas
Esperado: 2-4 hipótesis que explican los patrones principales, cada una respaldada por observaciones específicas. Al menos una hipótesis debería ser sorprendente o contraria. La distinción entre observación e interpretación se mantiene — es claro qué partes son datos y cuáles son teoría.
En caso de fallo: Si no se forman hipótesis, las observaciones pueden necesitar más tiempo para acumularse — regresar al Paso 2. Si se forman demasiadas hipótesis (todo es "quizás"), seleccionar las 2-3 con la evidencia más fuerte y apartar el resto. Si solo se forman hipótesis obvias, forzar una vista contraria: "¿Qué pasaría si lo opuesto fuera verdadero?"
Paso 6: Archivar — Almacenar la biblioteca de patrones
Preservar las observaciones e hipótesis para referencia futura.
- Resumir los hallazgos clave: 3-5 patrones con evidencia
- Declarar las hipótesis principales y sus niveles de confianza
- Notar lo que no fue observado (potenciales puntos ciegos)
- Identificar observaciones de seguimiento que fortalecerían o debilitarían las hipótesis
- Si los patrones son duraderos (serán relevantes entre sesiones), considerar actualizar MEMORY.md
- Etiquetar las observaciones con contexto: cuándo fueron hechas, qué las motivó, qué alcance se cubrió
Esperado: Un archivo sobre el cual futuras sesiones de observación pueden construir. El archivo distingue claramente entre observaciones (datos) e hipótesis (interpretación). Es honesto sobre niveles de confianza y brechas.
En caso de fallo: Si las observaciones no se sienten dignas de archivar, pueden haber sido demasiado superficiales — o pueden ser genuinamente rutinarias (no toda sesión de observación produce percepciones). Archivar incluso resultados negativos: "Observé X y no encontré anomalías" es contexto futuro útil.
Validación
- El marco de observación fue establecido antes de que comenzara cualquier observación (no exploración sin forma)
- Las observaciones crudas fueron registradas como hechos antes de cualquier interpretación
- Al menos 5 observaciones discretas fueron capturadas con evidencia específica
- La interpretación (hipótesis) fue claramente separada de la observación (datos)
- Al menos un hallazgo sorprendente o contrario fue generado
- El registro archivado es lo suficientemente específico para que otro observador lo verifique
Errores Comunes
- Intervención prematura: Ver un problema y arreglarlo inmediatamente, perdiendo la oportunidad de entender el patrón más amplio al que pertenece
- Sesgo de observación: Ver lo que se espera en lugar de lo que está presente. Las expectativas filtran la percepción — el paso de limpieza en el Paso 1 mitiga esto pero no lo elimina
- Parálisis por análisis: Observar interminablemente sin nunca pasar a la acción. Establecer un límite de tiempo o puntos de datos y comprometerse a concluir
- Imposición narrativa: Construir una historia que conecte observaciones incluso cuando las conexiones son débiles. No todas las observaciones forman una narrativa coherente — hallazgos desconectados son válidos
- Confundir familiaridad con comprensión: "He visto esto antes" no es lo mismo que "Entiendo por qué esto está aquí." La exposición previa puede crear falsa confianza
- Ignorar las propias reacciones: Las reacciones emocionales o cognitivas del observador a las observaciones son datos. Una sensación de confusión, aburrimiento o alarma sobre un sistema a menudo contiene señal real
Habilidades Relacionadas
observe-guidance— la variante de guía humana para entrenar a una persona en observación sistemáticalearn— la observación alimenta el aprendizaje proporcionando datos crudos para la construcción de modeloslisten— atención enfocada hacia afuera hacia señales del usuario; la observación es atención de alcance más amplio hacia cualquier sistemaremote-viewing— exploración intuitiva que puede ser validada mediante observación sistemáticameditate— desarrolla la capacidad de atención sostenida que la observación requiereawareness— consciencia situacional enfocada en amenazas; la observación es impulsada por curiosidad en lugar de defensa
GitHub リポジトリ
関連スキル
llamaguard
その他LlamaGuardは、暴力やヘイトスピーチなど6つの安全性カテゴリーにおいて、LLMの入力と出力をモデレートするMetaの70-80億パラメータモデルです。94〜95%の精度を提供し、vLLM、Hugging Face、Amazon SageMakerを使用してデプロイ可能です。このスキルを使用して、AIアプリケーションにコンテンツフィルタリングと安全策を簡単に統合できます。
cost-optimization
その他このClaudeスキルは、リソースの適正サイジング、タグ付け戦略、支出分析を通じて、開発者がクラウドコストを最適化することを支援します。AWS、Azure、GCPにわたるクラウド支出の削減とコストガバナンスの実施のためのフレームワークを提供します。インフラコストの分析、リソースの適正サイジング、または予算制約への対応が必要な際にご利用ください。
quantizing-models-bitsandbytes
その他このスキルは、bitsandbytesを使用してLLMを8ビットまたは4ビット精度に量子化し、精度の低下を最小限に抑えつつ50〜75%のメモリ削減を実現します。限られたGPUメモリでより大規模なモデルを実行したり、推論を高速化するのに理想的で、INT8、NF4、FP4などのフォーマットをサポートしています。HuggingFace Transformersと統合され、QLoRAトレーニングや8ビットオプティマイザーを可能にします。
dispatching-parallel-agents
その他このClaudeスキルは、複数のエージェントを配備し、3つ以上の独立した問題を並行して調査・修正します。共有状態や依存関係がなく解決可能な、無関係な障害が発生するシナリオ向けに設計されています。中核となる機能は並列問題解決であり、効率を最大化するために独立した問題領域ごとに1つのエージェントを割り当てます。
