← ClaudeAtlas

self-improvelisted

Propose improvements to agent/skill/rule definitions from accumulated feedback-ledger defects and eval reports. Proposal-only - applies changes exclusively after evals show no regression AND the user approves. Trigger with /self-improve.
This-HW/hiway-kit · ★ 3 · AI & Automation · score 79
Install: claude install-skill This-HW/hiway-kit
# Self-Improve feedback ledger에 누적된 **반복 결함**을 근원(에이전트·스킬·룰 정의)에 반영하는 재귀 개선 루프 — 단, **제안-전용(proposal-only)**이다. 적용은 게이트를 통과해야만 한다. > **적용 범위**: 이 킷 레포 전용 프로젝트 스킬이다(`.claude/skills/` — 플러그인에 실리지 > 않는다, v5.0.0). `evals/`·`scripts/`·`plugins/common/` 경로는 전부 레포 루트 기준이다. <HARD-GATE> 정의 파일(.md) 수정을 **적용된 상태로 남기려면** 다음 전부 충족: 1. **커버리지 판정 선행**: 수정 대상에 대응하는 eval 시나리오(`evals/scenarios/<agent>/`)가 있는가? - **있음** → 관련 evals(`--agent <name>`)가 baseline 대비 후퇴 없음(진짜 회귀 없음) - **없음**(스킬·룰·시나리오 없는 에이전트) → **eval 게이트는 미적용이다.** exit 0을 "게이트 통과"로 계산·보고하는 것은 게이트 착시(false-green)이며 금지. "EVAL COVERAGE 없음 — 사용자 승인이 유일한 게이트"임을 명시 고지한다. 2. 사용자가 diff를 보고 **명시적으로 승인** evals 실행 불가(exit 2 SKIPPED)면 제안까지만 — SKIPPED를 통과로 위장 금지. 자동 커밋 금지 — 커밋은 항상 사용자/메인 세션의 별도 결정. **승인 전의 워킹 트리는 항상 깨끗해야 한다** (아래 4단계: 모든 분기에서 롤백 후 승인 시에만 재적용 — 미승인 diff가 트리에 잔존하면 게이트 실패로 간주하고 중단). </HARD-GATE> > 위치 근거: 학습 루프(ledger→LESSONS)는 "같은 실수를 세션이 회피"하게 하지만, > 결함의 근원이 정의 파일에 있으면 매 세션 회피 비용을 낸다. 이 스킬은 그 근원을 > 고치는 마지막 단계다. 안전망의 실체는 대상별로 다르다 — eval 커버리지가 있는 > 대상(`evals/scenarios/<agent>/` 존재로 판정)은 이중 게이트, 그 외에는 > **사용자 승인 단일 게이트**임을 숨기지 않는다. ## 절차 ### 0. 전제 - repo root 기준으로 실행: `ROOT=$(git rev-parse --show-toplevel)` 후 모든 경로는 `$ROOT` 기준 (CWD 가정 금지). - 시작 시 `git status --porcelain`으로 대상 정의 파일들이 깨끗한지 확인 — 이미 dirty면 사용자에게 보고하고 중단 (남의 변경 위에 제안을 얹지 않는다). ### 1. 입력 수집 - **ledger 전량**: 원장 파일을 **직접 읽는다**. 경로는 `plugins/common/tools/feedback_ledger.py` 의 `ledger_path()` 가 정한다(`<git-common-dir>/kit/ledger.md`) — 하드코딩하