跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

omh-app-debugging

[omh] Application code misbehaves -- a wrong value, a flaky test, a lost update: reproduce it first, form competing hypotheses, discriminate them with the cheapest observation, and only then fix the demonstrated root cause. Use when the user says: app-debugging, app debugging, application debugging, root cause, root-cause, find the root cause, root cause analysis, flaky test.

rlaope · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add rlaope/oh-my-hermes --skill omh-app-debugging

技能说明


name: "omh-app-debugging" description: "[omh] Application code misbehaves -- a wrong value, a flaky test, a lost update: reproduce it first, form competing hypotheses, discriminate them with the cheapest observation, and only then fix the demonstrated root cause. Use when the user says: app-debugging, app debugging, application debugging, root cause, root-cause, find the root cause, root cause analysis, flaky test." metadata: hermes: tags: [workflow, oh-my-hermes, verification] category: verification phase: app-root-cause role: reviewer quality_tier: root-cause-evidence-gated

App Debugging

This is an OMH app-debugging workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).

Why This Exists

app-debugging exists because a wrong result in application code had no owner: native-debugging covers native binaries, build-failure-triage covers red builds, and agent-debug covers agent misbehaviour, so the most common debugging request dispatched straight to an execution lane that skipped the diagnosis.

First Steps

  • Ask for, or plan, the one command that shows the wrong behaviour, and record its observed output before naming a cause.
  • Refuse to prepare a fix while the reproduction reads not_observed; plan the observation that would establish it instead.

Do Not Use When

  • The fault is a crash, memory corruption, or core dump in a compiled native binary that needs a debugger session; use native-debugging.
  • The build, compile, or CI job fails the same way on every run; use build-failure-triage.
  • The subject is an agent or workflow run that misbehaved rather than the application code; use agent-debug.
  • The cause is already demonstrated and the request is to judge whether the fix is proven; use verification-gate.

Examples

Good example:

  • Prompt: a test fails one run in five in CI, how do I find out why
  • Expected behavior: Prepare reproduction_record/v1 with the loop that measures the failure rate, competing_hypotheses/v1 across ordering, shared state, timing, and environment, and the cheapest observation that splits them; no fix yet.
  • Why: The failure is intermittent, so the first deliverable is a measured reproduction rather than a patch.

Bad example:

  • Prompt: add a sleep before the assertion so the flaky test passes
  • Expected behavior: Record the sleep as a symptom mask, keep root cause open, and plan the observation that names the race.
  • Why: A timing change that hides the failure leaves the fault in place and removes the reproduction.

Completion Checklist

  • The reproduction names its command, observed output, expected output, and hit rate, and reads observed before any fix is prepared.
  • At least three hypotheses on distinct axes were written before the first observation was chosen.
  • Each observation records which hypotheses its result eliminated.
  • The root cause cites the demonstrating observation and the observation that ruled out each rival.
  • The fix handoff carries the reproduction as a regression test that fails before and passes after.

Recovery Notes

  • If the fault does not reproduce, make reproduction the first hypothesis and plan the loop, seed, or ordering that would establish it.
  • If every hypothesis is eliminated, record that, widen the axes, and keep root cause unclaimed rather than promoting the last survivor.

Use When

Use when application code -- a Python, TypeScript, Go, or JVM service, library, or test -- behaves wrongly and the cause is unknown: a wrong value, an intermittent or order-dependent test, a race or lost update, or a bug that moves when observed. The work is a demonstrated root cause: an observed reproduction, competing hypotheses, the cheapest observation that separates them, and only then a fix.

Strong routing signals: `app-debugging`, `app debugging`, `application debugging`, `root cause`, `root-cause`, `find the root cause`, `root cause analysis`, `flaky test`, `flaky tests`, `test is flaky`, `intermittent test failure`, `fails intermittently`, `fails one run in`, `passes locally but fails in ci`, `heisenbug`, `bug disappears`, `disappears when i add a print`, `race condition`, `lost update`, `update is lost`, `wrong return value`, `returns the wrong value`, `reproduce the bug`, `minimal reproduction`

Catalog Metadata

Category: verification Phase: app-root-cause Quality tier: root-cause-evidence-gated Reasoning demand: standard

Quality bar:

  • State the symptom and the expected behaviour separately from any suspected cause.
  • Record the reproduction with its hit rate; an intermittent fault is reproduced when its rate over N runs is measured, not when it happened once.
  • Load references/hypothesis-and-race-method.md for the hypothesis table, flaky-test tactics, and race patterns instead of improvising them.
  • Pick the next observation by cost and by how many hypotheses its result eliminates, and record the eliminations.
  • Keep reproduction, root cause, fix, and verification as separate observed states.

Required inputs:

  • the wrong behaviour as observed, and the behaviour that was expected
  • the command, request, or test that shows it, and how often it shows it
  • language, framework, and what changed recently when known
  • logs, stack traces, or failing assertions already captured
  • observed reproduction and verification evidence for any root-cause or fix claim

Expected outputs:

  • reproduction_record/v1
  • competing_hypotheses/v1 with at least three hypotheses on distinct axes
  • discriminating_observation_plan/v1
  • root_cause_record/v1
  • fix_handoff/v1 blocked until reproduction_record/v1 reads observed
  • observed_fix_verification/v1 when observed

Artifact expectations:

  • reproduction_record/v1 names the exact command, the input, the observed output, the expected output, and the hit rate over N runs; it reads observed or not_observed and nothing between
  • competing_hypotheses/v1 spans distinct axe
阅读完整来源 ↗