observe-guidance
Acerca de
Esta habilidad guía a los usuarios a través de la observación sistemática para depuración, investigación o análisis de sistemas. Enseña atención neutral, metodología de notas de campo, reconocimiento de patrones e informes estructurados. Úsala cuando necesites comprender el comportamiento de un sistema antes de actuar o para crear informes basados en evidencia.
Instalación rápida
Claude Code
Recomendadonpx 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-guidanceCopia y pega este comando en Claude Code para instalar esta habilidad
Documentación
觀察(指導)
引導人施行對系統、現象或模式之系統化觀察。AI 為田野研究教練——助立觀察目標之框、備協議、維持中立注意、以田野筆記錄發現、分析模式,並以資料與釋分明之方式報告觀察。
適用時機
- 人欲於介入前了解系統行為(以觀察除錯而非試誤)
- 有人正進行研究或蒐證,需結構化之觀察方法
- 人總跳結論,須培觀察先於釋之紀律
- 有人備一證據為本之報告,非觀點
- 人欲透過直接觀察了解團隊動態、用戶行為或流程效益
meditate-guidance培養持續注意後,欲將注意轉向特定系統
輸入
- 必要:人欲觀察者(系統、流程、行為、代碼庫、團隊動態、自然現象)
- 必要:何故觀察(除錯、研究、稽核、好奇、改進)
- 選擇性:可資觀察之時間(單會話 vs. 多日研究)
- 選擇性:先前了解系統之嘗試(已試者)
- 選擇性:欲測之具體問題或假設
- 選擇性:可資記錄之工具(筆記本、螢幕擷取、日誌、指標)
步驟
步驟一:立框——定義觀察目標
助人立清晰、有界之觀察框。
- 問所欲觀察者:「你欲了解何系統或行為?」
- 助縮範圍:「該系統之何具體面向最引興趣?」
- 辨觀察目的:了解、除錯、改進、蒐證或純粹好奇
- 立邊界:何在內、何在外(防觀察無止擴張)
- 若有假設:明述之,後擱之——「我等將尋支持與反對之證據」
- 擇觀察立場:
- 博物學家:觀而不干(最適了解行為)
- 控制式:變一變數而觀其效(最適除錯)
- 縱貫式:跨時觀察(最適偵趨勢)
預期: 清晰之觀察框,含明確目標、範圍、目的與立場。人知所視為何、所不視為何。
失敗時: 若人不能縮焦點(「我欲了解一切」),助擇一入口:「何一行為你最覺困惑?」若人已執結論(「我只需證 X」),輕戰之:「何見可駁此?我等兩相尋之。」
步驟二:備——立觀察協議
助人立記所觀之系統化方式。
- 依觀察類擇記錄方法:
- 代碼庫/系統:檔路徑、行號、時戳、日誌條目
- 行為/流程:時戳筆記,附行動者、行動與上下文
- 團隊/溝通:引述、發話者標識、非言語線索
- 自然/物理:草圖、量測、環境條件
- 建簡單記錄範本:
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) │
└─────────────┴────────────────────────────────────────────────────────┘
- 強調分明:「觀察列為事實。假設列為釋。永勿混。」
- 設最少觀察數:「下結論前至少求 10 個觀察。」
- 如適用,建監測工具:日誌、指標、螢幕錄製
預期: 人備好記錄方法,並了觀察與釋之關鍵分別。覺已備可始。
失敗時: 若範本過於正式,簡化為:「但寫所見,再分寫所思之義。」若拒記(「我會記得」),釋未記之觀察受記憶偏差影響——書寫之動使觀察更準。
步驟三:觀察——練持續中立之注意
引人經實際觀察會話。
- 提醒立場:「你乃博物學家研究新物種。勿干——但觀。」
- 首 5 分鐘:勵純觀察不記錄——但注意
- 初浸後:始用範本記錄
- 教中立語言:「不曰『系統當機』,試曰『系統於 14:32 處理第 47 請求後停止回應』」
- 察釋潛入觀察:「此乃釋——記於假設列」
- 勵記意外:「何使你驚?意外常含最有價值之資料」
- 定期查框:「你仍觀察始時所立之事,還是注意已飄?」
- 若欲介入:「記欲變者及其因,但尚未變——續觀」
預期: 人生 5-10 個附具體證據之具體觀察。經驗觀察與釋之別,覺維持中立注意較預期難。
失敗時: 若人持釋而不觀,試此練習:「描述所見如釋之於從未見此系統者。但用可驗事實。」若速速無事可觀,所視層次過高——引縮至細節:時序、順序、邊例、例外。
步驟四:記錄——以田野筆記捕發現
助人將原始觀察組為結構化筆記。
- 共審其錄之觀察
- 查完整:每觀察後可了解之上下文是否足夠?
- 查事實準確:陳述可驗,還是含隱藏假設?
- 將相似觀察分群:「你見任何模式形成嗎?」
- 記頻率:每模式現多少次?
- 記缺:「你期見而未見者為何?」
- 助分強觀察(清晰證據)與弱觀察(曖昧資料)
預期: 一組組織化之田野筆記,潔分觀察與釋。筆記詳實足夠,他人可獨立驗觀察。
失敗時: 若筆記過模糊(「事似慢」),助加具體:「多慢?相對於何?於何條件?」若筆記過詳(記一切),助辨何觀察關於原框、何為雜音。
步驟五:分析——辨模式並生假設
引人由觀察至結構化分析。
- 攤開所有觀察並尋模式:
- 重複:「此發生多次——是否系統性?」
- 相關:「X 總與 Y 同現——是否相關?」
- 次序:「A 總先於 B——A 可能致 B?」
- 缺:「於條件 Z 下 X 從不發生——何故?」
- 異常:「皆循模式 P 唯此例外——何不同?」
- 對每模式問:「有無另解釋?」
- 生 2-3 個假設解釋諸主要模式
- 分相關與因果:「觀察 A 與 B 共現未證 A 致 B」
- 辨何假設可測,何測可確認/駁之
- 記信心水準:何假設證據強,何為臆測
預期: 人由原始觀察轉至結構化假設,同時維持資料與理論分明之紀律。對其原問題至少有一可測假設。
失敗時: 若立跳一單解釋,戰之:「此乃一可能。另一為何?」若無見模式,觀察或太少——建議分析前繼觀。若每觀察似指同結論,或在過濾——問:「何證據可駁汝今之理論?」
步驟六:報告——以清晰結構分享發現
助人有效溝通其觀察。
- 結構報告:
- 背景:所觀者、何時、何故、何條件下
- 方法:觀察如何進行(協議、工具、持續時間)
- 發現:附證據之關鍵觀察(資料,非釋)
- 分析:所辨模式、所生假設、信心水準
- 建議:建議之下一步(續觀、測試、介入)
- 限制:觀察未涵者、潛在偏差
- 助以中立語言寫發現,分事實與釋
- 審隱藏假設或無支持之主張
- 若觀察為除錯:將假設轉為具體測試
- 若觀察為報告:確證據具體引用
- 若觀察為個人了解:摘要關鍵洞見與餘下問題
預期: 清晰之報告,傳達觀察、模式與假設,同時維持所觀與所推之分。讀者可獨立評證據。
失敗時: 若報告將觀察埋於釋,重構:「將事實全置一節,理論全置另一。」若報告缺信心水準(「此一定因…」),助校之:「你多確定?何可變你之念?」
驗證
- 觀察開始前已立觀察目標之框(非自由漫遊)
- 已立記錄協議並一貫使用
- 觀察作為事實記錄,與釋分
- 至少捕 5 個具體、有證據之觀察
- 模式由分析辨識,非自始假定
- 假設可測且有所述之信心水準
- 人經驗觀察先於釋之紀律
常見陷阱
- 觀察為確認偏差:但觀支持先有信念之事。框中當含「尋反假設之證據」為明確指示
- 介入欲:見問題即欲修。過早介入常遮根因——先觀察,再以全了解介入
- 記錄疲勞:詳細觀察心力耗大。建議休息與實際會話長度(30-60 分鐘專注觀察已可觀)
- 協議過繁:簡單觀察用筆記本與時戳即足。協議當服觀察,非代之
- 混觀察與監視:人際觀察中,倫理界限要緊。觀可見之行為,勿窺。觀人時透明常勝隱秘
- 跳框:無清晰觀察目標,注意散,發現失焦。粗框優於無框
相關技能
observe— 跨系統持續中立模式辨識之 AI 自我向變體learn-guidance— 觀察為學習供原始資料以了解listen-guidance— 聽乃對發話者之專注觀察;觀察為對任何系統之更廣注意remote-viewing-guidance— 共享為非本地感知所改編之結構化觀察方法read-garden— 用類似 CRV 改編感官協議之花園觀察技能
Repositorio GitHub
Habilidades relacionadas
evaluating-llms-harness
PruebasEsta Skill de Claude ejecuta el benchmark lm-evaluation-harness para evaluar modelos de lenguaje en más de 60 tareas académicas estandarizadas como MMLU y GSM8K. Está diseñada para que los desarrolladores comparen la calidad de los modelos, realicen seguimiento del progreso del entrenamiento o reporten resultados académicos. La herramienta admite varios backends, incluidos modelos de HuggingFace y vLLM.
cloudflare-cron-triggers
PruebasEsta habilidad proporciona conocimiento integral para implementar Cron Triggers de Cloudflare y programar Workers mediante expresiones cron. Cubre la configuración de tareas periódicas, trabajos de mantenimiento y flujos de trabajo automatizados, manejando problemas comunes como expresiones cron inválidas y inconvenientes de zonas horarias. Los desarrolladores pueden utilizarla para configurar manejadores programados, probar activadores cron e integrar con Workflows y Green Compute.
webapp-testing
PruebasEsta habilidad de Claude proporciona un kit de herramientas basado en Playwright para probar aplicaciones web locales mediante scripts de Python. Permite verificación de frontend, depuración de interfaz de usuario, captura de pantallas y visualización de registros, mientras gestiona los ciclos de vida del servidor. Úsela para tareas de automatización de navegadores, pero ejecute los scripts directamente en lugar de leer su código fuente para evitar contaminación del contexto.
finishing-a-development-branch
PruebasEsta habilidad ayuda a los desarrolladores a completar el trabajo terminado verificando que las pruebas pasen y luego presentando opciones estructuradas de integración. Guía el flujo de trabajo para fusionar, crear PRs o limpiar ramas después de que se completa la implementación. Úsala cuando tu código esté listo y probado para finalizar sistemáticamente el proceso de desarrollo.
