Menu
프로젝트에 규칙을 Skill 기반으로 추가하고 기존 규칙을 Skill로 변환합니다. 규칙 추가, 룰 추가, rule 추가, 새 규칙, 컨벤션 추가, 스타일 가이드 추가, 가이드라인 추가, 규칙 변환, rule 통합 요청 시 활성화.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
프로젝트 컨텍스트를 파악한 뒤 전문가 관점으로 코드 리뷰하고, 사용자 승인 후 Agent Team SPAWN으로 병렬 개선 작업을 수행합니다. 트리거: 코드리뷰, 코드 리뷰, code review, 리뷰해줘, 리팩토링, 코드검토, PR 리뷰, 변경사항 검토.
Claude Code Skill을 생성합니다. 스킬 생성, SKILL.md 작성, 새 스킬 만들기 요청 시 활성화.
기능 구현을 5단계(Requirements → Design → Task → Implementation → Review) 워크플로우로 체계적으로 진행합니다. Agent Team 기반 병렬 구현을 지원합니다. 워크플로우, 기능 구현, 기능 개발, 작업 재개, TASK-ID 패턴, .ai/tasks 요청 시 활성화.
Summary Bot 프로젝트의 아키텍처, 기술 스택, 코딩 컨벤션 규칙을 정의합니다. 코드 작성, 모듈 추가, 구조 변경, 컨벤션 확인 시 자동 참조됩니다.
| name | add-rules |
| description | 프로젝트에 규칙을 Skill 기반으로 추가하고 기존 규칙을 Skill로 변환합니다. 규칙 추가, 룰 추가, rule 추가, 새 규칙, 컨벤션 추가, 스타일 가이드 추가, 가이드라인 추가, 규칙 변환, rule 통합 요청 시 활성화. |
레포지토리 구조를 분석하여 Skill 기반 규칙을 적절한 위치에 추가하고, 기존 규칙 파일(.mdc, .cursorrules 등)을 Skill로 변환합니다.
규칙을 Skill로 추가할 때 3단계 로드 원칙을 적용합니다:
| 단계 | 역할 | 규칙 관점 | 위치 |
|---|---|---|---|
| Stage 1 | Discovery | 트리거 키워드로 활성화 판단 | frontmatter description |
| Stage 2 | Activation | 핵심 규칙만 (<500줄) | SKILL.md 본문 |
| Stage 3 | Execution | 상세 규칙, 예제, 엣지 케이스 | references/ |
판단 기준:
[1. 요청 분석] → [2. 구조 분석] → [3. 통합 패턴 결정] → [4. 사용자 확인] → [5. 규칙 추가]
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
대상 디렉토리 scripts/ 4가지 패턴 중 제안 검토 패턴별 실행
+ 모호함 확인 analyze-structure.sh 최적 선택 승인/수정
활용
대상 스킬 디렉토리를 반드시 먼저 확인합니다.
레포지토리에 따라 스킬 디렉토리가 다를 수 있습니다:
.claude/skills/ (프로젝트 자체의 스킬)skills/ (배포용 스킬 모음)규칙을 추가할 **대상 스킬 디렉토리**를 확인합니다:
- 이 프로젝트에서 실제 사용되는 스킬 디렉토리는 어디인가요?
- 예: `.claude/skills/`, `skills/`, 기타 경로
- (라이브러리 레포인 경우) 배포용 스킬과 프로젝트 자체 스킬을 구분해야 하나요?
이후 추가 확인:
| 확인 항목 | 질문 예시 |
|---|---|
| 규칙의 목적 | "이 규칙은 어떤 문제를 해결하나요?" |
| 적용 범위 | "특정 파일/디렉토리에만 적용되나요?" |
| 트리거 조건 | "언제 이 규칙이 활성화되어야 하나요?" |
| 기존 규칙 충돌 | "비슷한 기존 규칙이 있나요?" |
사용자가 지정한 스킬 디렉토리를 인자로 전달하여 분석합니다:
bash skills/add-rules/scripts/analyze-structure.sh {skills_dir}
# 예: bash skills/add-rules/scripts/analyze-structure.sh .claude/skills
# 예: bash skills/add-rules/scripts/analyze-structure.sh skills
상세 워크플로우는 references/workflow.md 참조.
| 패턴 | 설명 | user-invocable | 사용 시점 |
|---|---|---|---|
| A. 독립 Rule-Skill | 새 skill 디렉토리 생성 | false (자동 적용) | 새로운 독립 도메인 규칙 |
| B. 임베디드 Rules | assets/rules/ 패턴 | N/A (호스트 skill 따름) | 기존 워크플로우에 규칙 포함 |
| C. 기존 Skill 확장 | 기존 skill에 섹션/ref 추가 | 기존 설정 유지 | 기존 skill과 80%+ 관련 |
| D. Rule 변환 | 기존 rule 파일 → Skill 변환 | 소스에 따라 결정 | .mdc, .cursorrules 등 변환 |
새로운 독립 도메인의 규칙을 별도 skill로 생성합니다.
{skills_dir}/{rule-name}/
├── SKILL.md # user-invocable: false (자동 적용)
└── references/ # 필요시
└── detail.md
user-invocable: false로 설정하여 자동 적용feature-workflow 방식으로 호스트 skill의 assets/rules/에 규칙을 임베딩합니다.
{skills_dir}/{host-skill}/
├── SKILL.md # "규칙 로드" 섹션에서 참조
└── assets/
└── rules/
├── AGENTS.md # 규칙 인덱스
├── MUST/ # 필수 규칙
│ └── core-rule.md
└── domain/ # 도메인 규칙
└── specific-rule.md
기존 skill에 규칙 섹션이나 references 파일을 추가합니다.
기존 rule 파일(.mdc, .cursorrules, rules/*.md)을 Skill로 변환합니다.
| 소스 | 위치 | 변환 대상 |
|---|---|---|
| Claude rules | .claude/rules/*.md | Skill frontmatter + body |
| Cursor rules | .cursorrules, *.mdc | Skill로 재구조화 |
| 프로젝트 rules | rules/*.md | 적합한 패턴(A/B/C)으로 변환 |
상세는 references/conversion.md 참조.
새 독립 도메인? → 패턴 A (독립 Rule-Skill)
기존 워크플로우에 규칙 포함 필요? → 패턴 B (임베디드)
기존 skill과 80%+ 관련? → 패턴 C (기존 확장)
기존 rule 파일 변환? → 패턴 D (변환)
점수 기반 세부 판단 (패턴 A vs C):
| 기준 | 점수 |
|---|---|
| 동일 도메인의 기존 skill 존재 | +3 |
| 유사 트리거 조건 | +2 |
| 동일 적용 범위 | +2 |
| 기존 skill 500줄 미만 | +1 |
| description에 자연스럽게 언급 가능 | +1 |
총점 5점 이상 → 패턴 C (기존 확장) 권장, 미만 → 패턴 A (독립 생성)
상세는 references/patterns.md 참조.
| 규칙 유형 | user-invocable | description 예시 |
|---|---|---|
| 코딩 컨벤션 | false | "TypeScript 코딩 컨벤션. 코드 작성, 리뷰 시 자동 적용." |
| 스타일 가이드 | false | "React 컴포넌트 스타일 가이드. 컴포넌트 생성 시 자동 적용." |
| 작업 지침 | true (기본) | "코드 리뷰 체크리스트. 리뷰 요청 시 활성화." |
| 체크리스트 | true (기본) | "배포 전 체크리스트. 배포, deploy 요청 시 사용." |
# 좋은 description: 구체적 키워드 + 상황
description: >
TypeScript 네이밍 컨벤션. 변수명, 함수명, 클래스명 작성 시 자동 적용.
TypeScript, 네이밍, naming convention 관련 작업 시 활성화.
# 나쁜 description: 모호하고 광범위
description: >
코드 품질을 높이는 규칙입니다.
규칙 추가 완료 후 확인:
[ ] name이 1-64자, 소문자/숫자/하이픈만 사용하는가?
[ ] name이 디렉토리명과 일치하는가?
[ ] description이 무엇+언제를 명확히 설명하는가?
[ ] 트리거 키워드가 포함되어 있는가?
[ ] SKILL.md가 500줄 이하인가?
[ ] 상세 내용이 references/로 분리되었는가?
[ ] 파일 참조가 상대 경로, 1단계 깊이인가?
[ ] 기존 규칙과 충돌이 없는가?
[ ] 사용자 승인을 받았는가?
[ ] Progressive Disclosure 단계별 분리가 적절한가?
create-skill의 상세 검증은 create-skill/references/validation.md 참조.
## 규칙 추가 완료
- **이름**: {name}
- **패턴**: A/B/C/D
- **경로**: {skills_dir}/{name}/ 또는 기존 skill 경로
### 생성/수정된 파일
| 파일 | 역할 | 줄 수 |
|------|------|-------|
| ... | ... | ... |
### 사용 방법
- 자동 적용: {조건}
- 수동 호출: `/{name}` (user-invocable인 경우)
### 검증 결과
[체크리스트 통과 여부]