improve

KO | EN

gitlite — search

#javascript #python #hacktoberfest #ai #llm #deep-learning #docker #nodejs #cli #awesome-list #security #mcp #openai #open-source

(★ 8,956)

가장 성능이 뛰어난 모델을 사용하여 코드베이스를 감사(audit)하고, 더 저렴한 모델이 실행할 수 있는 계획을 작성하세요.

파일 탐색기

최종 버전 다운로드 (.zip)

- marketplace.json
- plugin.json
- 001-extract-shadow-config-resolution.md
- - SKILL.md
LICENSE.md
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# improve

코드베이스를 감사(audit)하고 다른 에이전트가 실행할 구현 계획을 작성해 주는 에이전트 스킬입니다.

핵심 아이디어: 지능이 결실을 맺는 부분(코드베이스 이해, 무엇을 해야 할지 판단, 스펙 작성)에는 가장 성능이 뛰어난 모델을 사용하고, 실행은 더 저렴한 모델에 맡기는 것입니다. 이 스킬은 직접 코드를 구현하지 않습니다. 계획(plan) 그 자체가 결과물입니다.

```
you → /improve (expensive model, advises)
plans/ → 001-fix-n-plus-one.md (self-contained specs)
other agent → implements, tests, ships (cheap model, executes)
```

## Install

```bash
npx skills add shadcn/improve
```

[Agent Skills](https://agentskills.io) 포맷을 지원하는 모든 에이전트에서 작동합니다. 작성된 계획은 일반 마크다운 형식이므로 어떤 에이전트(또는 인간)든 가져다 사용할 수 있습니다.

## Usage

```
/improve full audit → prioritized findings → plans
/improve quick cheap pass: hotspots, top findings only
/improve deep exhaustive: every package, every category
/improve security focused audit (also: perf, tests, bugs, ...)
/improve branch audit only what the current branch changes
/improve next feature suggestions — where to take the project
/improve plan  skip the audit, spec one thing
/improve review-plan  critique and tighten an existing plan
/improve execute  dispatch a cheaper executor, review its work
/improve reconcile refresh the backlog: verify, unblock, retire
/improve ... --issues also publish plans as GitHub issues
```

## How to use

처음부터 끝까지 진행하는 전형적인 실행 흐름:

1. 저장소에서 에이전트를 열고 `/improve`를 실행합니다(비용을 아끼려면 `/improve quick` 실행).
2. 에이전트가 저장소를 매핑하고, 감사를 수행한 뒤, 발견된 문제 목록(findings table)을 반환합니다. 계획을 세우고 싶은 항목 번호를 회신합니다("plan 1, 3 and 5").
3. 계획이 `plans/` 디렉토리에 저장됩니다 — 각 항목별 파일 하나와 권장 순서가 담긴 색인(index)이 생성됩니다. 내용을 읽어보세요. 검토용으로 작성되었습니다.
4. 에이전트에게 계획을 전달하거나("implement plans/001-*.md"), 스킬을 직접 실행시킵니다: `/improve execute 001`. 격리된 워이트리(worktree)에서 더 저렴한 모델을 배치하고, 계획과 비교하여 diff를 검토한 뒤, 판정 결과를 보고합니다. 병합(merging)은 사용자의 몫입니다.
5. 다음 세션에서는 `/improve reconcile`을 실행하여 백로그를 정리합니다: 반영된 내용을 확인하고, 변경된 내용을 새로고침하고, 막힌 부분을 해소합니다.

PR을 생성하기 전에 `/improve branch`를 실행하면 현재 브랜치에서 변경된 내용만 대상으로 동일한 작업을 수행합니다.

## Example

[shadcn/ui](https://github.com/shadcn-ui/ui)를 대상으로 실행했을 때 다음과 같은 결과가 도출되었습니다:

```
| # | Finding | Category | Effort | Confidence |
|---|------------------------------------------------|-----------|--------|------------|
| 1 | shadow-config duplicated in search.ts/view.ts, | tech-debt | M | HIGH |
| | copies already drifted (TODO at search.ts:31) | | | |
| 2 | O(n²) icon migration (migrate-icons.ts:168) | perf | S | HIGH |
```

…또한 몇 가지 항목은 거부되었으며, 다음 실행 시 다시 나타나지 않도록 이유가 기록되었습니다:

```
- [SEC-01] https\_proxy env var "SSRF": by-design — standard proxy convention,
every CLI honors it. Not a finding.
```

1번 항목을 선택하여 [이러한 계획](./examples/001-extract-shadow-config-resolution.md)이 생성되었습니다 — 현재 코드 발췌, 정확한 단계, 검증 게이트로서 저장소 고유의 테스트/린트 명령어, 그리고 상황이 일치하지 않을 때를 위한 중단(STOP) 조건이 포함되어 있습니다.

## How it works

\*\*정찰(Recon).\*\* 저장소를 매핑합니다: 기술 스택, 컨벤션, 그리고 정확한 빌드/테스트/린트 명령어 — 이들은 모든 계획에서 검증 게이트가 됩니다. 또한 존재하는 경우 의도 및 디자인 문서(`docs/adr/`, PRDs, `CONTEXT.md`, `DESIGN.md`, `PRODUCT.md`)를 읽어들입니다. 이를 통해 이미 결정된 트레이드오프가 문제점으로 다시 지적되지 않으며, 방향성 제안은 명시된 제품 의도에 기반하게 되고, 계획은 저장소 고유의 어휘를 사용하게 됩니다. 이러한 문서를 이미 유지하고 있는 모든 저장소와 호환됩니다.

\*\*감사(Audit).\*\* 정확성, 보안, 성능, 테스트 커버리지, 기술 부채, 종속성 및 마이그레이션, DX, 문서, 방향성(기능 제안 — 모든 제안은 일반적인 뜬구름 잡는 소리가 아니라 저장소 자체의 증거를 인용해야 함)의 9가지 범주에 걸쳐 병렬 서브에이전트를 배치합니다. 모든 발견된 항목에는 `file:line` 증거, 영향도, 투입 공수(effort)가 포함됩니다.

그리고 신뢰성.
\*\*검증(Vet).\*\* 서브에이전트가 과도하게 보고하므로, 어드바이저가 무언가를 보여주기 전에 인용된 모든 위치를 직접 다시 읽습니다. 오탐은 제거되고, 잘못된 귀속은 수정되며, 거부 내역은 기록됩니다.
\*\*우선순위화(Prioritize).\*\* 발견된 항목들은 레버리지(영향도 ÷ 노력, 신뢰도로 가중치 부여) 순으로 정렬된 표에 기록됩니다. 당신은 어떤 것을 계획으로 삼을지 선택합니다.
\*\*계획(Plan).\*\* 선택된 발견 사항당 하나의 파일이 인덱스, 우선순위 순서, 의존성 그래프와 함께 `plans/`에 작성됩니다.
## 계획이 실행 가능한 이유
계획은 가장 능력이 부족할 만한 실행자(어드바이저 세션을 본 적이 없고 훨씬 더 작을 수 있는 모델)를 위해 작성됩니다. 이를 뒷받침하는 세 가지 속성:
- \*\*자기 완결성(Self-contained).\*\* 모든 컨텍스트가 인라인으로 포함됩니다. 정확한 파일 경로, 현재 상태의 코드 발췌, 모범 사례 파일이 포함된 리포지토리 규칙, 검증된 명령어 등이 포함됩니다. "위에서 논의한 바와 같이" 같은 표현은 없습니다.
- \*\*검증 관문(Verification gates).\*\* 모든 단계는 명령어와 그 예상 출력으로 끝납니다. 완료 기준은 기계적으로 확인 가능합니다. 실행자는 성공 여부를 스스로 판단할 필요가 없습니다.
- \*\*엄격한 경계(Hard boundaries).\*\* 작은 모델이 현실과 계획이 일치하지 않을 때 즉흥적으로 행동하도록 내버려두는 대신, 명시적인 범위 외(out-of-scope) 목록과 중단 조건("X인 경우 중단하고 보고할 것")을 제공합니다.
또한 각 계획에는 작성 기준이 된 git 커밋이 기록되므로, 실행자는 무엇인가를 건드리기 전에 기계적인 변경(drift) 검사를 실행합니다.
## 피드백 루프 완성 (Closing the loop)
계획은 던져두고 잊어버리는 것이 아닙니다:
- \*\*`execute`\*\*는 격리된 git 워이트리에서 더 저렴한 실행자 서브에이전트를 생성하고, 계획을 전달한 뒤, 테크 리드처럼 결과를 검토합니다. 모든 완료 기준을 다시 실행하고, 범위 준수 여부를 확인하며, 의도에 대비한 diff를 읽습니다. 판정: 승인(머징 여부는 항상 사용자가 결정), 수정 요청(최대 2회), 또는 차단 및 계획 구체화.
- \*\*`reconcile`\*\*은 그동안 발생한 일을 처리합니다. 완료된(DONE) 계획이 여전히 유지되는지 검증하고, 차단된(BLOCKED) 계획을 조사하여 장애물을 우회하도록 다시 작성하며, 변경된 계획을 갱신하고, 독립적으로 수정된 발견 사항은 폐기합니다.
- \*\*`--issues`\*\*는 계획을 GitHub 이슈로 발행합니다. 동일한 자기 완결적 본문을 가지므로, 어떤 에이전트나 인간이라도 작업이 이미 존재하는 곳에서 이어서 작업을 시작할 수 있습니다.
## 엄격한 규칙
- 소스 코드를 직접 수정하지 않습니다. 유일한 쓰기 작업은 `plans/`에만 이루어집니다. 실행자는 일회용 워이트리에서만 편집하며, 머징은 항상 사용자의 몫입니다.
- 작업 트리를 변경하는 명령어를 실행하지 않습니다. 읽기, 검색, 읽기 전용 분석만 수행합니다.
- 비밀 값(secret values)을 복제하지 않습니다. 위치와 자격 증명 유형만 다루며, 항상 교체를 권장합니다.
- 구현을 요청받았나요? 거절하고 계획을 가리킵니다(또는 `execute`를 제안합니다).
## 라이선스
MIT © shadcn

improve

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

improve

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README