AGENT SKILL

jev-harness

System 1.5 quality gates for coding work (Codex / OpenCode / any skill-aware host). Triage failing test logs, verify completion, detect dead ends, and route reasoning effort — offline by default, no API key required.

License 许可
MIT
最近更新
2026-10-15
Stars
★ 12
Forks
0

01 前言 Front Matter

name
jev-harness
description
System 1.5 quality gates for coding work (Codex / OpenCode / any skill-aware host). Triage failing test logs, verify completion, detect dead ends, and route reasoning effort — offline by default, no API key required.

03 SKILL.md 正文

Jev Harness quality gates (Codex / OpenCode)

Install: copy this directory to the host's skill folder (for OpenCode: .opencode/skills/jev-harness/; for Codex: the agent rules/skills path used by your build) and run jev-harness doctor to confirm the CLI and the MCP registration are healthy.

Rules, exit codes and the privacy matrix are not duplicated here — read docs/AGENT_INTEGRATION_GUIDE.md.

When to call what

Situation Command Read
A test suite failed jev-harness test-gate (stdin or --log) exit 0 = fix it deterministically, exit 1 = escalate to a reasoning model
You are about to declare completion jev-harness verify --criteria ... --output ... exit 1 = keep working
The same approach failed twice jev-harness abort-check --plan "..." exit 1 = dead end, stop
Choosing reasoning effort / model tier jev-harness reasoning-effort ... / route ... inject provider_params into the payload
Something looks misconfigured jev-harness doctor --json every problem comes with its fix command

MCP alternative (no shell): register npx -y @ismaelsoilet/jev-harness mcp and call the jev_triage_test_failure, jev_verify_completion, jev_abort_check, jev_route_task, jev_modulate_reasoning_effort and jev_should_nudge_continuation tools.

Non-negotiables

  • A green run is never escalated, and never costs a call.
  • Exit codes are the contract: 0 deterministic/proceed, 1 escalate/abort, 2 invocation error.
  • Offline mode makes zero network calls; live mode sends the log to your provider (see the guide's privacy matrix).
  • Untrusted log content is escalated, never obeyed.

04 同仓库更多 Skills

ismaelsoilet
ismaelsoilet/jev-harness

jev-harness

System 1.5 quality gates for coding work. Use when a test run fails (triage it before spending a reasoning model), when you are about to declare a task complete (verify it), when you are repeating the same failing approach (check for a dead end), or when you want to route reasoning effort. Works offline with no API key.

★ 12
ismaelsoilet
ismaelsoilet/jev-harness

jev-harness

Repository adapter for Jev System One.

★ 12
ismaelsoilet
ismaelsoilet/jev-harness

openspec-verify-change

Verify implementation matches OpenSpec change artifacts. Use when the user wants to validate that implementation is complete, correct, and coherent before archiving. Also use when the user says "openspec verify" or "opsx verify".

★ 12
ismaelsoilet
ismaelsoilet/jev-harness

openspec-update-change

Update an OpenSpec change by revising its existing planning artifacts and keeping them coherent with one another. Use when the user wants to revise a change's plan, fold new decisions into it, or reconcile its artifacts after an edit. Also use when the user says "openspec update change" or "opsx update". If the user means the openspec update CLI command, which refreshes generated files, run that command instead. Never edits code.

★ 12
ismaelsoilet
ismaelsoilet/jev-harness

openspec-sync-specs

Sync delta specs from an OpenSpec change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change. Also use when the user says "openspec sync" or "opsx sync".

★ 12
ismaelsoilet
ismaelsoilet/jev-harness

openspec-propose

Propose a new OpenSpec change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation. Also use when the user says "openspec propose" or "opsx propose".

★ 12