返回 Skill 列表
extension
分类: 开发与工程无需 API Key

dialogue-log-observation

记录一个观察(测量、状态或事件)。在工作执行过程中记录事实观察时使用。触发词为“记录观察”、“记录观察”、“记下发现”、“捕捉状态”。

person作者: jakexiaohubgithub

Dialogue: Observation Logger

Log an observation to the observation log.

When to Use

Use this skill when you need to record:

  • A measurement (quantitative data)
  • A state observation (system/process state)
  • An event (something that occurred)

How to Log an Observation

Execute the following bash command:

${CLAUDE_PLUGIN_ROOT}/skills/dialogue-log-observation/scripts/log-observation.sh <type> <observer> <subject> <value> [context] [tags]

Required Parameters

| Parameter | Values | Description | |-----------|--------|-------------| | type | MEASUREMENT, STATE, or EVENT | Category of observation | | observer | ai:claude or human:<id> | Who made the observation | | subject | text | Brief description of what was observed | | value | text | The observed data, state, or event details |

Optional Parameters

| Parameter | Description | |-----------|-------------| | context | Additional surrounding situation | | tags | Comma-separated categorisation tags |

Observation Types

| Type | Use For | Example | |------|---------|---------| | MEASUREMENT | Quantitative data | "3 tests failed, 47 passed" | | STATE | System/process state | "Build pipeline is broken" | | EVENT | Occurrences | "User requested code review" |

Examples

Measurement Observation

${CLAUDE_PLUGIN_ROOT}/skills/dialogue-log-observation/scripts/log-observation.sh MEASUREMENT "ai:claude" "Test results" "3 failed, 47 passed" "After applying fix to auth module" "testing,ci"

State Observation

${CLAUDE_PLUGIN_ROOT}/skills/dialogue-log-observation/scripts/log-observation.sh STATE "ai:claude" "Build status" "Pipeline failing on lint stage" "Since commit abc123" "ci,blocking"

Event Observation

${CLAUDE_PLUGIN_ROOT}/skills/dialogue-log-observation/scripts/log-observation.sh EVENT "ai:claude" "User action" "Requested implementation of feature X" "During planning session" "requirements"

Output

The script returns the generated observation ID (e.g., OBS-20260113-143000).

Sharing

Always commit and push immediately after logging an observation. This ensures team visibility and supports transactive memory—others need to see observations promptly to maintain shared situational awareness.

git add .dialogue/logs/observations/ && git commit -m "OBS-YYYYMMDD-HHMMSS: <subject>" && git push