rule-manager

📁 khw1031/ai-library 📅 1 day ago
0
总安装量
1
周安装量
安装命令
npx skills add https://github.com/khw1031/ai-library --skill rule-manager

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
continue 1
kimi-cli 1

Skill 文档

Rule Manager

레포지토리 구조를 분석하여 Skill 기반 규칙을 적절한 위치에 추가합니다.

핵심 원칙

  1. 모호하면 물어본다: 불명확한 요구사항은 반드시 확인
  2. 구조 우선 분석: 기존 패턴을 파악한 후 결정
  3. 사용자 확인 필수: 추가/수정 전 반드시 승인 요청
  4. Progressive Disclosure: 규칙도 3단계 로드 원칙 적용

워크플로우 개요

[요청 접수] → [구조 분석] → [위치 판단] → [사용자 확인] → [규칙 추가]
     │            │             │              │              │
     ▼            ▼             ▼              ▼              ▼
  모호함 확인   skills/     기존 추가 or    제안 검토      SKILL.md 생성
               agents/      새 구조 제안    승인/수정      또는 기존 수정
               rules/ 파악

1단계: 요청 분석

사용자 요청을 받으면 다음을 확인합니다:

확인 항목 질문 예시
규칙의 목적 “이 규칙은 어떤 문제를 해결하나요?”
적용 범위 “특정 파일/디렉토리에만 적용되나요?”
트리거 ì¡°ê±´ “언제 이 규칙이 활성화되어야 하나요?”
기존 규칙 충돌 “비슷한 기존 규칙이 있나요?”

모호한 경우 반드시 질문합니다.

2단계: 구조 분석

레포지토리의 규칙 관련 구조를 분석합니다:

# 기존 skills 확인
ls -la skills/

# 기존 rules 확인 (있는 경우)
ls -la rules/ 2>/dev/null || echo "rules/ 없음"

# assets/rules 확인 (있는 경우)
ls -la assets/rules/ 2>/dev/null || echo "assets/rules/ 없음"

# 기존 패턴 파악
find . -name "SKILL.md" -o -name "*.mdc" -o -name ".cursorrules" 2>/dev/null

분석 결과 보고:

## 현재 구조 분석 결과

- **Skills**: X개 존재 (skills/)
- **Rules**: Y개 존재 (경로)
- **패턴**: [발견된 패턴 설명]
- **관련 기존 규칙**: [있으면 나열]

3단계: 위치 판단

분석 결과를 바탕으로 규칙의 위치를 판단합니다:

판단 기준 결정
유사한 기존 skill 있음 기존 skill에 내용 추가
새로운 도메인 새 skill 생성
여러 skill에 공통 상위 레벨 skill 또는 references/ 분리

판단 유형:

A. 기존 Skill에 추가

기존 skills/{name}/SKILL.md 에 섹션 추가
또는 references/에 새 파일 추가

B. 새 Skill 생성

skills/{new-name}/
├── SKILL.md
└── references/ (필요시)

C. 기존 구조 개선 제안

현재: 분산된 규칙들
제안: 통합 또는 재구조화

4단계: 사용자 확인

반드시 다음 형식으로 제안하고 승인을 받습니다:

## 규칙 추가 제안

### 규칙 정보
- **이름**: {name}
- **목적**: {purpose}
- **트리거**: {when}

### 위치 결정
- **유형**: 기존 추가 / 새 생성
- **경로**: skills/{name}/...
- **이유**: {why}

### 변경 내용 미리보기

[변경될 내용 또는 새로 생성될 파일 미리보기]

---

이대로 진행할까요? (Y/N/수정 요청)

5단계: 규칙 추가

사용자 승인 후 실행합니다:

새 Skill 생성 시

mkdir -p skills/{name}/references

SKILL.md 작성 (progressive-disclosure 원칙 적용):

---
name: {name}
description: >
  {무엇을 하는지 1-2문장}
  {언제 활성화되는지 트리거 키워드}
user-invocable: false  # 자동 적용 규칙인 경우
---

# {제목}

{핵심 내용 - 500줄 이하}

## 상세 가이드

- [상세 내용](references/detail.md)

기존 Skill 수정 시

  1. 기존 SKILL.md 백업 (선택적)
  2. 적절한 섹션에 내용 추가
  3. 500줄 초과 시 references/로 분리

규칙 유형별 설정

규칙 유형 user-invocable 설명
코딩 컨벤션 false 자동 적용
스타일 가이드 false 자동 적용
작업 지침 true (기본값) 명시적 호출
체크리스트 true 명시적 호출

체크리스트

규칙 추가 완료 후 확인:

[ ] name이 1-64자, 소문자/숫자/하이픈만 사용하는가?
[ ] description이 무엇+언제를 명확히 설명하는가?
[ ] 트리거 키워드가 포함되어 있는가?
[ ] SKILL.md가 500줄 이하인가?
[ ] 상세 내용이 references/로 분리되었는가?
[ ] 기존 규칙과 충돌이 없는가?
[ ] 사용자 승인을 받았는가?

완료 보고

## 규칙 추가 완료

- **이름**: {name}
- **경로**: skills/{name}/
- **파일**:
  - SKILL.md
  - references/ (있는 경우)

### 사용 방법

- 자동 적용: {조건 설명}
- 수동 호출: `/{name}` (user-invocable인 경우)

### 검증 결과

[체크리스트 통과 여부]

상세 가이드