Lennith/MyCodexSkills

코드 슬림 리팩터

트리거 경계

이 스킬은 사용자가 명시적으로 구조적 단순화 또는 수렴 리팩터를 원할 때만 사용합니다.

다음의 경우에는 트리거하지 마십시오:

• 사소한 정리
• 일상적인 버그 수정
• 일회성 이름 변경
• 전용 수렴 워크플로우가 필요하지 않은 일반적인 리팩터

모드

실행당 하나의 모드를 선택하십시오:

• quick: 작거나 잘 정의된 영역을 위한 가벼운 수렴 패스
• strict: 전체 추적 가능성과 병합 게이트를 갖춘 정식 리팩터 패스

사용자가 정식, 감사 가능 또는 릴리스 민감 리팩터를 요청하지 않는 한 기본값은 quick입니다.

필수 입력

• repo_path: Git 저장소의 절대 경로
• refactor_goal: 한 줄 수렴 목표
• scope: 선택적 경로 또는 모듈 범위
• mode: quick 또는 strict
• target_branch: strict에만 필요, 기본값 master

핵심 규칙

이 워크플로우는 기본적으로 기존 외부 호환성을 유지하지 않지만, 범위가 지정된 시스템의 의도된 현재 계약은 반드시 유지해야 합니다.

단지 테스트를 통과시키기 위해 백엔드 계약, 응답 의미, 또는 어설션 표준을 절대 변경하지 마십시오.

빠른 모드(Quick)

작업이 제한적이고 사용자가 주로 정식 아티팩트 추적이 아닌 수렴을 원할 때 quick을 사용하십시오.

필수 단계:

1. 목표, 범위, 제거할 주요 복잡성을 명시합니다.
2. 대화 또는 필요한 경우 최소한의 로컬 노트에 간단한 작업 목록을 유지합니다.
3. 해당 작업 목록에 연결된 범위 내 변경만 적용합니다.
4. 백엔드 계약, 응답 의미, 어설션 표준을 유지합니다.
5. 변경된 영역에 대해 집중 검증을 실행합니다.
6. 검증 결과 백엔드/테스트 불일치가 나타나면 중단하고 추가 편집 전에 계약 불일치 게이트를 실행합니다.
7. 제거된 복잡성, 유지된 사항, 남아 있는 위험을 보고합니다.

./slim_refactor/ 아티팩트는 quick 모드에서 선택 사항입니다.

엄격 모드(Strict)

리팩터가 추적 가능하고 감사 가능하며 병합 게이트가 필요할 때 strict를 사용하십시오.

필수 게이트:

1. 전용 작업 브랜치를 생성하고 사용합니다. 대상 브랜치에서 직접 편집하지 마십시오.
2. 코드 편집 전에 설계를 작성합니다.
3. ./slim_refactor/ 아래에 아티팩트를 추적합니다:
   • todolist.md
   • plan.md
   • report.md
4. 백엔드 계약, 응답 의미, 어설션 표준을 유지합니다.
5. 모든 변경 라운드마다 검토를 실행합니다.
6. 검증 결과 백엔드/테스트 불일치가 나타날 때마다 계약 불일치 게이트를 실행합니다.
7. 병합 전에 전체 워크플로우 게이트를 실행합니다.

계약 불일치 게이트(Contract-Mismatch Gate)

테스트가 실제 회귀가 아닌 계약 불일치를 반영할 수 있는 방식으로 실패할 때마다 이 게이트를 사용하십시오.

필수 작업:

1. 분류가 완료될 때까지 구현 변경을 중단합니다.
2. 현재 동작, 의도된 현재 계약, 테스트 기대치를 비교합니다.
3. 서브에이전트를 사용할 수 있을 때 독립적인 서브에이전트 검토를 시작합니다.
4. 서브에이전트를 사용할 수 없으면 명시적인 로컬 검토 대체를 수행하고 해당 대체를 라운드 출력에 기록합니다.
5. 불일치를 정확히 다음 중 하나로 분류합니다:
   • backend_regression: 백엔드 동작이 의도된 현재 계약에 대해 잘못되었습니다.
   • stale_tests: 테스트가 의도된 현재 계약보다 뒤쳐져 있습니다.

분류 후 허용되는 작업:

• backend_regression: 백엔드 동작을 의도된 현재 계약으로 수정합니다. 문제를 숨기기 위해 테스트를 약화시키지 마십시오.
• stale_tests: 영향을 받은 테스트만 업데이트하거나 해당 라운드에서 해당 테스트를 건너뜁니다. 백엔드 계약이나 어설션 표준을 완화하지 마십시오.

테스트가 건너뛰어지면 라운드를 종료하기 전에 오래된 게이트 상태, 건너뛴 범위, 필요한 후속 조치를 보고합니다.

실행 워크플로우

빠른(Quick)

1. 목표, 범위, 검증 대상을 확인합니다.
2. 가장 작은 일관된 변경 세트로 필수적이지 않은 복잡성을 제거합니다.
3. 새로운 추상화보다 삭제와 수렴을 선호합니다.
4. 구조를 변경하면서 의도된 현재 백엔드 계약을 유지합니다.
5. 영향을 받는 범위를 검증합니다.
6. 검증 결과 계약/테스트 불일치가 나타나면 추가 편집 전에 계약 불일치 게이트를 실행합니다.
7. 수렴 결과와 잔여 위험을 요약합니다.

엄격(Strict)

1. target_branch를 체크아웃하고 동기화합니다.
2. BASE_SHA를 기록합니다.
3. codex/refactor/<topic>-<YYYYMMDD> 브랜치를 생성합니다.
4. ./slim_refactor/todolist.md를 생성하거나 업데이트합니다.
5. ./slim_refactor/plan.md를 생성하거나 업데이트합니다.
6. 계획에 선언된 작업만 구현합니다.
7. 구조를 수렴하면서 의도된 현재 백엔드 계약을 유지합니다.
8. 각 변경 라운드에 대해 검토를 실행하고 결과를 ./slim_refactor/report.md에 기록합니다.
9. 검증 결과 계약/테스트 불일치가 나타나면 계약 불일치 게이트를 실행하고 검토자 유형과 분류를 기록합니다.
10. 전체 워크플로우 게이트를 실행합니다.
11. 추적 가능성과 병합 또는 차단 결정을 포함하여 report.md를 마무리합니다.

출력 요구 사항

항상 보고:

• 제거된 복잡성
• 수렴된 구조
• 검증 결과
• 남아 있는 위험
• 유지되거나 수정된 계약 불변 조건
• 해당하는 경우 불일치 분류
• 불일치 검토가 발생한 경우 검토자 유형(subagent 또는 local_fallback)
• 오래된 테스트가 발견된 경우 변경되거나 건너뛴 테스트

strict의 경우 추가로 보고:

• 브랜치 이름
• 아티팩트 경로
• 검토 결과
• 병합 또는 차단 결정

참조

• references/workflow-checklist.md
• references/design-spec-template.md
• references/todolist-template.md
• references/plan-template.md
• references/report-template.md