quick
Quick harness evaluation — checklist-based scoring in ~30 seconds. Runs deterministic checks against the target project and produces a score, grade, and improvement suggestions.
- License 许可
- MIT
- 最近更新
- 2026-09-24
- Stars
- ★ 19
- Forks
- 2
01 前言 Front Matter
- name
- quick
- effort
- low
- description
- Quick harness evaluation — checklist-based scoring in ~30 seconds. Runs deterministic checks against the target project and produces a score, grade, and improvement suggestions.
03 SKILL.md 正文
You are performing a Quick harness evaluation. This is a fast, checklist-based assessment that produces a score and grade.
Steps
-
Identify target project: Use the current working directory as the target project root. Verify it exists and contains at least some files.
-
Run scoring script: Execute the scoring engine:
HARNESS_EVAL_ROOT="${CLAUDE_PLUGIN_ROOT}" bash "${CLAUDE_PLUGIN_ROOT}/scripts/scoring.sh" --mode quick "$(pwd)"Capture the JSON output. Exit code 1 means some checks failed and is a normal result; only exit code 2 is a script error.
-
Parse results: Extract from the JSON:
scores.overall— numeric score (1.0-10.0)scores.grade— letter gradechecklist— per-tier pass/total countsresults— individual check pass/fail details
-
Generate bilingual report: Present results in English and Korean, separated by a horizontal rule. Use this format:
# Harness Quick Evaluation **Score: {overall}/10 ({grade})** **Date: {timestamp}** ## Checklist Results | Tier | Passed | Total | Status | |------|--------|-------|--------| | Basic (6.0+) | X | Y | ✓/✗ | | Functional (7.0+) | X | Y | ✓/✗ | | Robust (8.0+) | X | Y | ✓/✗ | | Production (9.0+) | X | Y | ✓/✗ | ## Failed Checks (For each FAIL: its description and tier, then the fix — the file path to create or change, with example content) ## Next Steps (The improvements that would move the project to the next tier, highest impact first — as many as the failed checks warrant) --- # 하네스 Quick 평가 **점수: {overall}/10 ({grade})** **날짜: {timestamp}** ## 체크리스트 결과 | 단계 | 통과 | 전체 | 상태 | |------|------|------|------| | 기본 (6.0+) | X | Y | ✓/✗ | | 기능적 (7.0+) | X | Y | ✓/✗ | | 견고 (8.0+) | X | Y | ✓/✗ | | 프로덕션 (9.0+) | X | Y | ✓/✗ | ## 실패 항목 (각 FAIL 항목의 설명과 단계, 그리고 해결 방법 — 만들거나 수정할 파일 경로와 예시 내용) ## 다음 단계 (다음 단계 도달에 필요한 개선 사항 — 실패 항목에 맞춰 필요한 만큼, 영향도 순) -
Save reports to files: Save the English and Korean reports as separate files in the target project:
mkdir -p .harness-eval/reports- English report:
.harness-eval/reports/eval-{YYYY-MM-DD}-{NNN}-quick-en.md - Korean report:
.harness-eval/reports/eval-{YYYY-MM-DD}-{NNN}-quick-ko.md
{YYYY-MM-DD}is the UTC date of the scoring output'stimestamp. Quick runs are not recorded in history (/harness-eval:compareworks from saved Standard and Full runs), so{NNN}is a per-day Quick report counter, not a history ID: list today's Quick reports withls .harness-eval/reports/eval-$(date -u +%F)-*-quick-en.md 2>/dev/null || true(it prints nothing when there are none) and use one more than the highest{NNN}found, zero-padded to three digits (001if there are none). This keeps a second Quick run on the same day from overwriting the first.Use the Write tool to create each file. After saving, inform the user of the file paths.
- English report:
Error Handling
- If scoring.sh exits with code 2 (script error), show the error message and suggest checking dependencies (jq installed? correct path?)
- If the target has no
.claude/directory at all, the score will be very low. Suggest running/initin a Claude Code session to create a CLAUDE.md, then adding.claude/settings.jsonwith permissions and hooks. - If jq is not installed, tell the user:
sudo apt install jqorbrew install jq
Tone
Be direct and constructive. Focus on what to do next, not what's wrong.
Language
Always produce the report in both English and Korean. English section first, then a horizontal rule (---), then the Korean section. Tables, scores, file paths, and code blocks are identical in both sections — only the prose text differs.
04 同仓库更多 Skills
summarize
Summarize a document using an alias and the max effort level
standard
Standard harness evaluation — static analysis, dynamic testing, and checklist scoring in 2-3 minutes. Produces a detailed report with findings and improvement roadmap. Dynamic testing runs the target's hooks and tests after the user confirms. Pass --static-only for repositories you do not trust.
full
Full harness evaluation — multi-agent deep analysis across 12 dimensions (safety, completeness, design quality) with parallel evaluators and a synthesized report. Takes 5-10 minutes. Produces a scored report in English and Korean with an executive summary and improvement roadmap. Use when the user explicitly asks for a full, deep, or multi-agent harness evaluation. For a quick score use quick; for static plus dynamic checks use standard.
compare
Compare harness evaluation history — shows score trends, per-tier deltas, diminishing returns detection, and next grade projection.
sync-docs
Bring harness-eval's CLAUDE.md files, architecture docs, and manifests back in line with the current code. Use when the user asks to sync or audit docs, or after structural changes.
release
Cut a harness-eval release - bump the version in the three manifest fields and the README version badge, update CHANGELOG (EN+KO), tag. Use only when the user asks to release.