agentsclimarketplace

He fix bugs

Skill jscraik/Agent-Skills/Plugins/harness-engineering/fixtures/budget-archive/2026-04-21/deferred-store/skills/team_automation/he-fix-bugs

Governed skill foundry and Skills SDK for Codex/AI coding agents: author, validate, evaluate, and sync runtime projections through ask.

Install
npx -y skills add jscraik/Agent-Skills --skill he-fix-bugs

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Restore broken behavior by reproducing failures, identifying root cause, and delivering verified fixes. Use when the user needs regression debugging, incident triage, or bug repair from tracker or direct reports.

SKILL.md

7.9 KB, ~1.6k tokens by cl100k_base, as published. Nobody here has run it

Progressive Disclosure Entry

This entrypoint stays concise and keeps full operational context in archived references.

Use

  • Use this skill as the canonical Harness Engineering bug-fixing stage.
  • For full stage policy, workflow details, and examples, load the archived full guide.

Philosophy

  • Reproduce first, then diagnose, then fix.
  • Root-cause clarity beats patch velocity.
  • Investigate before proposing changes, and keep the causal chain from trigger to symptom explicit.

When to use

  • Use when regressions, runtime failures, or tracker defects require evidence-backed debugging.
  • Use when issue reproduction and verification are required before coding changes.
  • Use when prior fix attempts failed and the request needs disciplined root-cause analysis instead of more trial-and-error edits.
  • Use when the user starts a QA session or reports bugs conversationally and wants durable Linear issues.

Inputs

  • Symptom report, repro context, and affected scope.
  • Logs, traces, tests, and relevant code paths.
  • Optional issue-tracker reference or pasted issue context.
  • Relevant CONTEXT.md when issue language uses project-specific terms.
  • Execution permission: diagnosis-only or diagnose-and-fix.
  • Optional QA-intake mode when reports need Linear issue filing before diagnosis.

Outputs

  • Reproduction evidence, root-cause analysis, fix scope, and verification outcome.
  • Linear issue payloads or URLs for QA intake, including single/breakdown decision and blocker links.
  • Clear next action when blocked or when diagnosis is complete but remediation is not yet chosen.
  • Regression test recommendation and why existing checks missed the issue when that is knowable.
  • Include schema_version: 1 when structured output is requested.

Procedure

  1. Parse intake first: symptom report, tracker context, expected behavior, and any prior failed attempts.
  2. If the request is a QA session or conversational report, run QA intake: ask at most 2-3 focused questions, lightly inspect domain language, decide single issue vs breakdown, and file or prepare Linear issue payloads before diagnosis.
  3. Compare issue language with CONTEXT.md when present so aliases or domain misunderstandings do not become false bug scope.
  4. For runtime, CLI, startup, agent-routing, or session-log failures, collect bounded runtime evidence before reproduction: identify relevant logs/config paths, read only tails or targeted matches, capture [ERROR]/[WARN] markers, and state when logging began too late to prove the original failure.
  5. Reproduce and stabilize the failing behavior before proposing changes.
  6. Trace backward from the symptom to the point where valid state first became invalid.
  7. Test one hypothesis at a time, and for uncertain links require a prediction that can confirm or falsify the chain.
  8. Present the root cause, proposed fix scope, and test recommendations before remediation when the request is diagnosis-first or confidence is still settling.
  9. When remediation is in scope, check workspace safety, prefer failing-test-first validation, apply the minimal fix, and verify no regressions.

Validation

  • Confirm reproduction and post-fix verification are both recorded.
  • Confirm the causal chain from trigger to symptom is explicit before fix work proceeds.
  • Confirm fix addresses root cause instead of symptom masking.
  • Confirm Linear issue wording, expected behavior, and domain terms agree or explicitly name the mismatch.
  • Confirm QA-created Linear issues avoid file paths and line numbers, include reproduction steps, and use behavior-focused domain language.
  • Confirm blocked or partial outcomes name the exact missing condition, evidence gap, or next safest route.
  • Fail fast: stop at first failed gate and do not proceed.

Constraints

  • Redact secrets, credentials, tokens, and sensitive data by default.
  • Do not mark issue fixed without successful verification evidence.
  • Do not skip straight to edits when reproduction or root-cause evidence is still missing.
  • Do not patch around a domain-model contradiction; route to he-deepen-spec when behavior meaning is unclear.
  • Do not create GitHub issues or ADRs for QA intake unless the user explicitly overrides the Linear-first project convention.
  • Do not over-interview during QA intake; ask only the minimum short questions needed to file a durable issue.
  • Do not use shotgun debugging or bundle unrelated changes into one bug fix.
  • Apply the context-disposition policy: move important still-valid context to references and index it when meaningful; intentionally discard stale, duplicated, unsafe, superseded, or low-signal text.

Anti-patterns

  • Skipping deterministic reproduction and guessing a fix.
  • Shipping fixes that lack regression checks.
  • Accepting a symptom fix when the causal chain prediction failed.
  • Treating tracker intake, diagnosis, and issue management as one speculative step.

Examples

  • "When the user asks, Can you inspect this regression that started after the auth refactor, reproduce it, and find the root cause before you fix anything?"
  • "Please investigate this crash, but stop at diagnosis and test recommendations because I do not want edits yet."
  • "Help me validate why the last two quick patches failed and tell me what is actually broken."
  • "Can you run a QA session and file Linear issues for each bug I report?"

Full Context

Subagent Routing

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.