MCP HubMCP Hub
스킬 목록으로 돌아가기

observe-guidance

pjt222
업데이트됨 Yesterday
1 조회
17
2
17
GitHub에서 보기
테스팅aidesign

정보

이 스킬은 사용자가 행동하기 전에 시스템을 이해할 수 있도록 체계적인 관찰 방법을 안내합니다. 디버깅이나 연구를 위해 중립적인 데이터 수집, 패턴 인식, 구조화된 보고 방법을 코칭합니다. 결론을 내리기 전에 증거를 수집해야 할 때나 근거 기반 분석을 준비할 때 사용하세요.

빠른 설치

Claude Code

추천
기본
npx skills add pjt222/agent-almanac -a claude-code
플러그인 명령대체
/plugin add https://github.com/pjt222/agent-almanac
Git 클론대체
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/observe-guidance

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

Observe (Guidance)

Coach human in field study: frame → protocol → witness → record → analyze → report. Separate fact from interpretation.

Use When

  • Person wants understand system before intervene (debug by obs, not trial-error)
  • Conducting research / evidence → needs structured method
  • Person jumps to conclusions → needs obs discipline
  • Preparing evidence-based report (not opinion)
  • Team dynamics, user behavior, process effectiveness via direct obs
  • After meditate-guidance cultivated attention → direct it at system

In

  • Required: What to observe (system, process, behavior, codebase, team, phenomenon)
  • Required: Why (debug, research, audit, curiosity, improvement)
  • Optional: Time available (single vs multi-day)
  • Optional: Prior attempts
  • Optional: Specific Qs / hypotheses
  • Optional: Recording tools (notebook, screen capture, logging, metrics)

Do

Step 1: Frame

Help set bounded frame.

  1. Ask what: "What system/behavior trying to understand?"
  2. Narrow scope: "What specific aspect interests you most?"
  3. Purpose: understanding / debug / improve / evidence / curiosity
  4. Boundaries: in/out scope → prevents endless expansion
  5. Hypothesis? state explicit, then set aside → "look for evidence both for + against"
  6. Stance:
    • Naturalist: no interfere (best for behavior)
    • Controlled: change one var, observe effect (best for debug)
    • Longitudinal: over time (best for trends)

→ Clear frame: target, scope, purpose, stance defined.

If err: can't narrow ("understand everything") → pick one entry point: "what behavior most confusing?" Already committed conclusion ("just prove X") → gently challenge: "what would disprove it?"

Step 2: Prep protocol

Systematic recording.

  1. Method by type:
    • Codebase/system: paths, line numbers, timestamps, log entries
    • Behavior/process: time-stamped notes — actor, action, context
    • Team/communication: quotes, speaker IDs, non-verbal cues
    • Natural/physical: sketches, measurements, env conditions
  2. Template:
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)     │
└─────────────┴────────────────────────────────────────────────────────┘
  1. Stress separation: "obs row = fact. hypothesis row = interpretation. Never mix."
  2. Min count: "≥10 obs before any conclusion"
  3. Set up monitoring tools if applicable

→ Recording method ready. Person gets obs↔interpretation distinction. Prepared.

If err: too formal → simplify: "write what you see, separately what you think it means." Resist recording ("I'll remember") → unrecorded = memory bias; writing makes obs accurate.

Step 3: Witness

Guide actual obs session.

  1. Remind stance: "naturalist studying new species. No interfere — just watch"
  2. First 5min: pure obs no recording — just attend
  3. After immersion: begin recording w/ template
  4. Coach neutral lang: instead "system crashed" → "system stopped responding 14:32 after 47th request"
  5. Watch interpretation creeping: "that's interpretation — record in hypothesis row"
  6. Note surprises: "what surprised? surprises = most valuable data"
  7. Check frame: "still observing what set out, or drifted?"
  8. Wants to intervene: "note what + why, but don't change yet — keep observing"

→ ≥5-10 concrete obs w/ specific evidence. Experiences obs vs interpret diff. Finds harder than expected.

If err: keep interpreting → exercise: "describe as if to someone never seen this. Only verifiable facts." Run out fast → too high level → zoom in: timing, ordering, edge cases, exceptions.

Step 4: Record

Organize raw → structured.

  1. Review together
  2. Completeness: enough context for later?
  3. Factual accuracy: verifiable, or hidden assumptions?
  4. Group similar: "patterns forming?"
  5. Frequencies: how often?
  6. Absences: "what expected but not there?"
  7. Strong (clear evidence) vs weak (ambiguous)

→ Organized field notes cleanly separate obs from interpretation. Detailed enough another can verify.

If err: too vague ("things slow") → add specifics: "how slow? compared to what? which conditions?" Too detailed (record everything) → which relate to frame, which noise.

Step 5: Analyze

Obs → structured analysis.

  1. Look for patterns:
    • Repetition: "happened many times — systematic?"
    • Correlation: "X always w/ Y — related?"
    • Sequence: "A always before B — A causes B?"
    • Absence: "X never in condition Z — why?"
    • Anomaly: "all follow P except this — what diff?"
  2. Each pattern: "alternative explanation?"
  3. 2-3 hypotheses
  4. Correlation ≠ causation: "co-occur ≠ proves cause"
  5. Testable + what test confirms/refutes
  6. Confidence levels: well-supported vs speculative

→ Raw obs → structured hypotheses, data/theory separation kept. ≥1 testable hypothesis for original Q.

If err: jumps single explanation → challenge: "one possibility. another?" No patterns → too few obs → continue. Every obs same conclusion → filtering → ask: "what would contradict your theory?"

Step 6: Report

Communicate findings.

  1. Structure:
    • Context: what/when/why/conditions
    • Method: protocol, tools, duration
    • Findings: key obs w/ evidence (data, not interpretation)
    • Analysis: patterns, hypotheses, confidence
    • Recommendations: next steps (more obs, test, intervene)
    • Limitations: not covered, potential biases
  2. Findings in neutral lang separating fact from interpretation
  3. Review for hidden assumptions / unsupported claims
  4. Debug? translate hypotheses → concrete tests
  5. Report? evidence cited specifically
  6. Personal? summarize insights + remaining Qs

→ Clear report communicates obs/patterns/hypotheses, distinction kept. Reader can evaluate evidence independently.

If err: buries obs in interpretation → restructure: "facts one section, theories another." No confidence ("definitely because...") → calibrate: "how sure? what would change mind?"

Check

  • Frame set before obs (not wandering)
  • Recording protocol established + used consistently
  • Obs as facts, separate from interpretations
  • ≥5 concrete evidence-backed obs
  • Patterns from analysis, not assumed
  • Hypotheses testable, stated confidence
  • Person experienced obs-before-interpret discipline

Traps

  • Confirmation bias: only obs supporting belief. Frame must include "look for evidence against your hypothesis"
  • Intervention urge: see + fix immediately → masks root cause → observe first
  • Recording fatigue: detail = taxing. Breaks + realistic lengths (30-60min focused = substantial)
  • Over-protocol: simple obs needs notebook+timestamps. Protocol serves obs, not replaces
  • Obs ≠ surveillance: ethical boundaries matter. Visible behavior, no spy. People → transparency > secrecy
  • Skip frame: no target → attention scatters → unfocused. Rough frame > none

  • observe — AI self-directed variant
  • learn-guidance — obs feeds learning
  • listen-guidance — focused obs of speaker; obs broader to any system
  • remote-viewing-guidance — shares method adapted for non-local
  • read-garden — garden obs uses similar CRV-adapted sensory protocols

GitHub 저장소

pjt222/agent-almanac
경로: i18n/caveman-ultra/skills/observe-guidance
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

연관 스킬

evaluating-llms-harness

테스팅

이 Claude Skill은 MMLU, GSM8K를 포함한 60개 이상의 표준화된 학술 과제에서 LLM 성능을 벤치마크하기 위해 lm-evaluation-harness를 실행합니다. 개발자들이 모델 품질을 비교하고, 학습 진행 상황을 추적하거나 학술 결과를 보고할 수 있도록 설계되었습니다. 이 도구는 HuggingFace와 vLLM 모델을 포함한 다양한 백엔드를 지원합니다.

스킬 보기

cloudflare-cron-triggers

테스팅

이 스킬은 cron 표현식을 사용하여 Worker를 스케줄링하기 위한 Cloudflare Cron Triggers 구현에 관한 포괄적인 지식을 제공합니다. 주기적 작업, 유지보수 작업, 자동화된 워크플로우 설정 방법을 다루며, 잘못된 cron 표현식이나 시간대 문제 같은 일반적인 이슈들을 해결하는 방법을 포함합니다. 개발자들은 이를 통해 스케줄된 핸들러 구성, cron 트리거 테스트, Workflows 및 Green Compute와의 연동 작업을 수행할 수 있습니다.

스킬 보기

webapp-testing

테스팅

이 Claude Skill은 Python 스크립트를 통해 로컬 웹 애플리케이션을 테스트하기 위한 Playwright 기반 툴킷을 제공합니다. 프론트엔드 검증, UI 디버깅, 스크린샷 캡처, 로그 확인 기능을 지원하며 서버 라이프사이클을 관리합니다. 브라우저 자동화 작업에 사용하되 컨텍스트 오염을 방지하기 위해 소스 코드를 읽지 않고 스크립트를 직접 실행하세요.

스킬 보기

finishing-a-development-branch

테스팅

이 스킬은 테스트 통과를 확인한 후 체계적인 통합 옵션을 제시하여 개발자가 완성된 작업을 마무리하도록 돕습니다. 구현이 완료된 후 머지, PR 생성, 브랜치 정리와 같은 워크플로우를 안내합니다. 코드가 준비되고 테스트가 완료되었을 때 개발 프로세스를 체계적으로 마무리하기 위해 사용하세요.

스킬 보기