moyu-lite

moyu-lite 개요

moyu-lite가 하는 일

moyu-lite는 코드 편집을 위한 가벼운 가드레일 스킬입니다. 사용자 요청의 정확한 범위 안에 머물도록 돕고, 불필요한 리팩터링, 새로운 추상화, 광범위한 재작성, 그리고 “친절해 보이는” 부수 수정은 피하게 합니다. Code Editing에서 깔끔한 개선보다 최소 diff를 우선하는 moyu-lite 스킬을 찾고 있다면, 이 스킬이 잘 맞습니다.

누가 사용하면 좋은가

moyu-lite는 하나를 고치려다 관련 없는 파일, 아키텍처, 동작까지 건드릴 위험이 큰 경우에 쓰면 좋습니다. 유지보수 작업, 작은 버그 수정, 부분 파일 편집, 그리고 사용자가 “X만 바꿔줘”, “그냥 간단하게”, “리팩터링하지 마”라고 말하는 요청에 특히 유용합니다.

무엇을 최적화하는가

이 스킬은 세 가지 원칙에 집중합니다. 요청받은 것만 바꾸기, 가장 단순한 해결책을 먼저 고르기, 애매하면 물어보기. 그래서 moyu-lite는 발상이나 확장보다 절제가 중요한 상황에서 가치가 큽니다. 큰 코드 해결책을 만들어내는 스킬이라기보다 범위를 통제하는 데 초점이 있으며, 실제로는 그 범위 통제가 코드 편집 워크플로의 가장 큰 병목인 경우가 많습니다.

moyu-lite 스킬 사용 방법

moyu-lite 설치 및 활성화

moyu-lite install의 경우, 환경에서 repo 경로를 통해 스킬을 추가한 뒤 에이전트가 편집 전에 스킬 파일을 읽고 있는지 확인하세요. 소스에 표시된 일반적인 설치 명령은 다음과 같습니다.
npx skills add uucz/moyu --skill moyu-lite

편집 요청을 좁고 명확하게 전달하기

가장 좋은 moyu-lite usage는 정확한 대상, 원하는 결과, 경계를 분명히 적은 요청에서 시작됩니다. 좋은 입력 예시는 다음과 같습니다. “src/auth.ts를 수정해서 로그인에서 이메일 별칭을 허용해 주세요. 다른 auth 로직이나 파일 구조는 바꾸지 마세요.” 반대로 “auth를 개선해 주세요”처럼 막연한 요청은 범위 확장을 부르고, 스킬이 추측해야 하는 상황을 만듭니다.

먼저 올바른 파일부터 읽기

먼저 SKILL.md를 읽고, 이어서 연결된 repo 안내 파일이 있다면 README.md, AGENTS.md, metadata.json, 그리고 존재할 경우 rules/, references/, resources/, scripts/ 같은 폴더를 확인하세요. 이 repo는 의도적으로 신호가 간결하므로, 추가 보조 파일을 찾아 헤매기보다 스킬 본문을 꼼꼼히 읽는 편이 더 중요합니다.

재작성 프롬프트가 아니라 편집 정책으로 쓰기

moyu-lite는 모델이 코딩을 시작하기 전에 적용하는 것이 가장 좋습니다. 현재 구조를 보존하고, diff를 제한하고, 요청이 커지면 확인을 멈추도록 지시하세요. 이렇게 하면 기존 코드를 패치할 때 특히 유용합니다. 이때 정답은 더 나은 아키텍처가 아니라, 대개 가장 작고 안전한 변경입니다.

moyu-lite 스킬 FAQ

moyu-lite는 작은 변경에만 쓰이나요?

아닙니다. 사용자가 좁고 통제된 변경을 중시하는 모든 Code Editing 작업에 맞습니다. 큰 기능이라도 diff를 최소화하고 요청되지 않은 리팩터링을 피하라는 지시라면 moyu-lite를 사용할 수 있습니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 작업을 설명하지만, 모델이 코드를 “개선”할 여지를 남겨둘 수 있습니다. moyu-lite는 명시적인 절제 계층을 추가합니다. 요청이 어떤 변경을 허용하지 않았다면, 그 변경은 범위 밖으로 봅니다. 그래서 재설계 보조가 아니라 신중한 편집자처럼 에이전트가 행동하길 원할 때 더 신뢰할 수 있습니다.

언제 moyu-lite를 쓰지 말아야 하나요?

탐색, 재설계, 전반적인 정리가 목적이라면 쓰지 마세요. 아키텍처를 다시 짜거나, 패턴을 통일하거나, 주변 코드를 함께 개선하는 기회로 삼고 싶다면 moyu-lite는 지나치게 보수적일 수 있습니다.

moyu-lite는 초보자도 쓰기 쉬운가요?

네. 규칙이 단순하기 때문입니다. 적게 바꾸고, 더 빨리 묻고, 가장 작은 올바른 수정안을 우선하면 됩니다. 초보자가 기억할 가장 중요한 점은, “도움이 되는” 추가 작업이야말로 이 스킬이 막으려는 대표적인 실패 방식이라는 사실입니다.

moyu-lite 스킬 개선 방법

편집 경계를 명확히 하세요

가장 강한 moyu-lite guide 입력은 정확한 파일, 영역, 허용 범위를 분명히 적습니다. “테스트는 건드리지 말 것”, “새 의존성 추가 금지”, “현재 API 유지”처럼 반드시 그대로 남겨야 하는 부분도 함께 써 주세요. 이렇게 하면 모호성이 줄고, 스킬이 의도를 추측하는 대신 절제를 제대로 적용할 수 있습니다.

허용 가능한 최소 결과를 설명하세요

사용자는 보통 우아함보다 결과의 안전성을 더 중요하게 봅니다. 최소 성공 조건을 분명히 적으세요. 예를 들어 “실패하는 분기만 고쳐 주세요”, “하드코딩된 경로를 바꿔 주세요”, “호출부는 건드리지 말고 이 함수만 조정해 주세요”처럼요. moyu-lite for Code Editing을 잘 작동시키려면, 한 번의 제한된 diff로 달성 가능한 목표를 주는 것이 좋습니다.

흔한 실패 패턴을 주의하세요

프롬프트가 모호하거나, 코드베이스가 지저분하거나, 주변 코드까지 개선하라는 초대로 보이는 작업일수록 스킬이 범위를 벗어나기 쉽습니다. 첫 결과가 추상화를 추가하거나, 무관한 파일을 건드리거나, 필요한 것보다 더 많이 다시 썼다면, 지시를 더 좁히고 경계를 다시 명시한 뒤 두 번째 시도를 요청하세요.

확장하지 말고 좁히면서 반복하세요

초기 결과가 너무 넓다면, 요청을 더 크게 만들지 말고 더 좁히세요. 정확한 줄, 파일, 유지해야 할 동작을 지정한 뒤, 빠진 편집만 요청하면 됩니다. moyu-lite에서는 더 좋은 결과가 보통 더 많은 맥락이 아니라 더 강한 제약에서 나옵니다.