self-healing

Files (1)

• SKILL.md

SKILL.md (first lines)

# self-healing

`$ARGUMENTS`에 대해 아래 루프를 수행한다:

- **Cycle 1**: `stress-interview` 실행 → `worker` 수정
- **Cycle 2**: 다시 `stress-interview` 실행 → `worker` 수정

총 **2 사이클**만 수행한다. 무한 반복하지 않는다.

## 목적
- 초기 구현의 결함, 리스크, 미검증 영역을 빠르게 줄인다.
- reviewer/verifier/challenger의 관점을 worker 수정 루프에 반영한다.
- 짧은 자동 안정화 루틴으로 품질을 끌어올린다.

## 실행 순서
1. 대상 범위를 1~2문장으로 고정한다.
2. `subagent` 호출이 필요하면 셸 바이너리가 아니라 **Pi 도구**로 호출한다. `bash`에서 `subagent ...`를 실행하지 말고, 반드시 `functions.subagent` 도구를 `{ "command": "subagent ..." }` 형태로 사용한다.
3. **Cycle 1**
   - `/skill:stress-interview $ARGUMENTS`
   - 결과에서 수정이 필요한 actionable item만 추린다.
   - `worker`에게 **해당 actionable item만** 수정하도록 요청한다.
4. **Cycle 2**
   - 다시 `/skill:stress-interview $ARGUMENTS`
   - 남은 actionable item만 추린다.
   - `worker`에게 다시 수정 요청한다.
5. 2사이클 후 종료하고, 남은 리스크와 미해결 항목을 명시한다.

## subagent Pi 도구 호출 방식

- `subagent`는 Pi harness가 제공하는 도구이며 로컬 터미널 바이너리가 아니다.
- 호출 인자는 단일 객체이고 키는 `command`다.
- `run`/`continue`에는 task separator `--`가 필수다.
- worker 수정 요청은 가능한 한 `--main`으로 현재 컨텍스트를 공유한다.
- 실행 직후 `status`/`detail`을 반복 polling하지 말고 완료/실패 follow-up을 기다린다.

예시:

```text
subagent({ command: "subagent help" })
subagent({ command: "subagent run worker --main -- \"Cycle 1 stress-interview 결과의 actionable item만 최소 수정으로 반영해줘: ...\"" })
```

## worker 지시 원칙
- stress-interview 결과 중 **구체적이고 재현 가능하며 수정 가치가 높은 항목만** 반영한다.
- 모호한 주장, 근거 부족 항목, 의도된 변경으로 보이는 항목은 자동 수정하지 않는다.
- 수정 범위를 불필요하게 넓히지 않는다.
- 각 사이클마다 가능한 최소 수정으로 진행한다.

## 사이클별 체크리스트
stress-interview 결과에서 reviewer findings 테이블의 `Fix` 컬럼과 `Pri` 컬럼을 활용하여 분류한다:

| 분류 | Pri | Fix | 처리 |
|------|-----|-----|------|
| Must fix now (auto) | 🔴 P0 / 🟠 P1 | AUTO_FIX | worker가 즉시 수정 |
| Must fix now (escalate) | 🔴 P0 / 🟠 P1 | ASK | **자동 수정 금지** · 사용자에게 에스컬레이션 |
| Good to fix | 🟡 P2 / ⚪ P3 | AUTO_FIX | low-risk cleanup, 수정 |
| Report as remaining risk | 🟡 P2 / ⚪ P3 | ASK | Remaining Risks에 기록만 |
| Do not auto-fix | - | INFO | 근거 부족 · 제품 의도 불명 · 대규모 설계 변경 필요 |

reviewer가 `Fix` 컬럼을 제공하지 않는 경우 기존 심각도 언어(Critical/Important/Minor)로 폴백한다.

## 종료 조건
다음 중 하나면 종료한다.
- 2사이클 완료
- 수정할 actionable item이 더 이상 없음
- worker가 범위 초과/불명확성으로 중단함

## 최종 응답 형식
1. `Cycle 1`
   - stress-interview 핵심 결과
   - worker가 반영한 수정
2. `Cycle 2`
   - stress-interview 핵심 결과
   - worker가 반영한 수정
3. `Remaining Risks`
   - 여전히 남은 문제
4. `Recommendation`
   - 추가 수동 작업 필요 여부

## 응답 표 형식
위 최종 응답은 가능하면 사이클별 수정 내역을 markdown 표로 정리한다.

| Cycle | 발견 이슈 | 심각도 | 조치 | 상태 |
|---|---|---|---|---|
| 1 | ... | P1 | worker 수정 | Fixed |
| 2 | ... | P2 | Remaining Risk | Open |

## 주의
- 이 스킬은 자동 수정 루프이므로, 변경 범위 통제가 가장 중요하다.
- 사용자 요청 범위를 벗어나는 리팩터링/정리는 하지 않는다.
- 마지막 상태가 "완벽함"이라고 단정하지 말고, 2사이클 기준의 남은 리스크를 솔직히 적는다.

From Jonghakseo/my-pi, MIT.

More from Jonghakseo/my-pi