AgentSkillsCN

drive

Google Drive基于上下文的整理技能。AI会分析文件名、内容和文件夹结构,进行语义分类、去重、版本管理和文件夹结构化。不同于简单的模式匹配,而是基于上下文理解的整理。

SKILL.md
--- frontmatter
name: drive
description: >
  Google Drive 맥락 기반 정리 스킬. AI가 파일명, 내용, 폴더 구조를 분석하여
  의미적으로 분류하고 중복 제거, 버전 관리, 폴더 구조화를 수행합니다.
  단순 패턴 매칭이 아닌 문맥 이해 기반 정리.
version: 2.1.0

triggers:
  keywords:
    - "drive 정리"
    - "드라이브 정리"
    - "파일 정리"
    - "폴더 정리"
    - "중복 제거"
    - "버전 관리"
    - "drive cleanup"
    - "drive organize"
    - "구글 드라이브 정리"
    - "drive audit"
    - "드라이브 감사"
    - "폴더 점검"
    - "구조 확인"
    - "드라이브 점검"
    - "폴더 구조 유지"
  context:
    - "Drive 파일 분류"
    - "문서 정리"
    - "폴더 구조화"
    - "구조 감사"
    - "드리프트 감지"

capabilities:
  - semantic_analysis      # 파일명/내용 의미 분석
  - duplicate_detection    # 중복 파일 탐지
  - version_management     # 버전 아카이빙
  - folder_restructure     # 폴더 재구조화
  - project_classification # 프로젝트별 분류

model_preference: opus  # 의미 분석에 Opus 권장

auto_trigger: true
auto_execute: true  # /drive 호출 시 자동 실행

Drive Organizer Skill

⚠️ 자동 실행 프로토콜 (CRITICAL)

/drive 호출 시 아래 단계를 순서대로 자동 실행합니다.

Step 1: 현황 수집 (MANDATORY)

python
from lib.google_docs.auth import get_credentials
from lib.google_docs.project_registry import ProjectRegistry

creds = get_credentials()
registry = ProjectRegistry()

# 프로젝트별 스캔
for project in registry.list_projects():
    folder_id = registry.get_folder_id(project)
    # 각 프로젝트 폴더 분석

출력 예시:

json
{
  "total_files": 150,
  "projects": {
    "WSOPTV": {"documents": 24, "images": 3},
    "EBS": {"documents": 4, "images": 0},
    "지지프로덕션": {"documents": 2, "images": 5},
    "브로드스튜디오": {"documents": 1, "images": 2}
  },
  "duplicates": 12,
  "unorganized": 55
}

Step 2: AI 분석 (Claude 직접 수행)

수집된 데이터를 분석하여:

  1. 프로젝트 분류: 파일명에서 프로젝트 키워드 추출

    • WSOPTV, WSOP TV, PRD-0002 → WSOPTV 프로젝트
    • EBS, PRD-0003 → EBS 프로젝트
    • 지지프로덕션, 지지 → 지지프로덕션 프로젝트
    • 브로드스튜디오, 브로드 → 브로드스튜디오 프로젝트
    • 개인 자료 → _개인
    • 그 외 → _아카이브
  2. 문서 유형 분류:

    • PRD-, Product Requirementprds/
    • Executive Summary, 요약executive/
    • STRAT-, Strategystrategy/
    • Analysis, 분석analysis/
  3. 버전/중복 감지:

    • v1, v2, v3 → 최신 버전만 유지
    • (사본), Copy of → 원본 확인 후 아카이브
    • 최종, Final → 최신 취급
  4. 정리 계획 생성:

    • 이동할 파일 목록
    • 생성할 폴더 구조
    • 아카이브할 구버전 목록

Step 3: 사용자 확인 (AskUserQuestion 사용)

code
📁 Drive 정리 계획

분석 결과:
- 총 파일: 150개
- 중복 파일: 12그룹 (30개)
- 미분류 파일: 55개

제안 작업:
1. 중복 파일 제거: 30개 → 12개
2. 프로젝트별 분류: WSOPTV(24), EBS(4), Archive(55)
3. 버전 아카이브: 8개 문서의 구버전 → _versions/

진행할까요?

AskUserQuestion 옵션:

  • "전체 실행 (권장)" - 모든 작업 수행
  • "중복 제거만" - 중복 파일만 정리
  • "분석만" - 실행 없이 결과 확인
  • "취소" - 작업 중단

Step 4: 실행 (승인 시)

bash
# 중복 제거
cd C:\claude && python -m lib.google_docs drive duplicates --delete

# 폴더 구조 생성
cd C:\claude && python -m lib.google_docs drive init

# 파일 정리 (프로젝트별 이동)
cd C:\claude && python -m lib.google_docs drive organize

또는 Drive API 직접 호출:

python
from lib.google_docs.auth import get_credentials
from lib.google_docs.project_registry import get_project_folder_id
from lib.google_docs.drive_organizer import DriveOrganizer

creds = get_credentials()

# 자동으로 프로젝트 감지
organizer = DriveOrganizer()

# 또는 특정 프로젝트 지정
wsoptv_folder = get_project_folder_id("WSOPTV")
organizer = DriveOrganizer(root_folder_id=wsoptv_folder)

# 폴더 생성
organizer.create_folder("prds", parent_id)

# 파일 이동
organizer.move_file(file_id, new_parent_id)

Step 5: 결과 리포트

code
============================================================
Google Drive Cleanup Complete
============================================================

✅ 완료된 작업
- 중복 파일 삭제: 18개
- 폴더 생성: 5개
- 파일 이동: 32개
- 버전 아카이브: 8개

📁 최종 구조
WSOPTV/
├── documents/ (9개)
└── images/ (3개)

EBS/
├── documents/ (4개)
└── images/ (0개)

지지프로덕션/
├── documents/ (2개)
└── images/ (5개)

브로드스튜디오/
├── documents/ (1개)
└── images/ (2개)

_개인/
├── 증명서/ (3개)
└── Meet Recordings/ (12개)

_아카이브/
└── (미분류 항목)

🔗 Drive: https://drive.google.com/drive/folders/...
============================================================

옵션별 실행

명령동작
/drive전체 자동 실행 (분석 → 확인 → 실행)
/drive --analyze분석만 (실행 없음)
/drive --project "WSOPTV"특정 프로젝트만 정리
/drive --dedupe중복 제거만
/drive --archive구버전 아카이브만
/drive --audit구조 감사 (거버넌스 점검)
/drive --audit --fix감사 + 교정 계획 생성
/drive --audit --fix --apply감사 + 교정 실행

Google Drive를 AI 맥락 분석 기반으로 정리하는 스킬입니다.


🎯 핵심 차별점

기존 스크립트 방식이 스킬 (AI 맥락 분석)
파일명 패턴 매칭 (PRD-*.md)문서 제목/내용의 의미적 분석
하드코딩된 분류 규칙맥락 기반 동적 분류
동일 파일명만 중복 감지유사 제목/내용 기반 중복 감지
수동 폴더 구조 정의프로젝트 분석 후 자동 제안

📋 워크플로우

code
┌─────────────────────────────────────────────────────────────┐
│                    Drive Organizer 워크플로우                 │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  Step 1: 현황 분석 (Scan)                                   │
│     ├── Drive API로 전체 파일/폴더 수집                     │
│     ├── 파일 메타데이터 추출 (이름, 수정일, 크기)           │
│     └── 문서 제목/첫 페이지 내용 샘플링                     │
│                                                              │
│  Step 2: AI 의미 분석 (Analyze)                             │
│     ├── 파일명 → 프로젝트/카테고리 추론                     │
│     ├── 유사 문서 그룹핑 (제목 유사도 분석)                │
│     ├── 버전 관계 파악 (v1, v2, 사본, 최종 등)             │
│     └── 고아 파일 식별 (분류 불가 항목)                    │
│                                                              │
│  Step 3: 정리 계획 생성 (Plan)                              │
│     ├── 폴더 구조 제안 (프로젝트별)                        │
│     ├── 파일 이동 계획 (from → to)                         │
│     ├── 중복/구버전 아카이브 계획                          │
│     └── 사용자 확인 요청                                    │
│                                                              │
│  Step 4: 실행 (Execute)                                     │
│     ├── 폴더 구조 생성                                      │
│     ├── 파일 이동                                           │
│     ├── 구버전 → _versions/ 아카이브                       │
│     └── 결과 리포트 출력                                    │
│                                                              │
└─────────────────────────────────────────────────────────────┘

🚀 사용법

기본 사용

bash
# 전체 Drive 분석 및 정리 (자동 실행)
/drive

# 특정 프로젝트만 정리
/drive --project "WSOPTV"

# 분석만 (실행 없이)
/drive --analyze

# 중복 제거만
/drive --dedupe

# 구버전 아카이브만
/drive --archive

대화형 사용

code
사용자: 드라이브 정리해줘
Claude: [Drive Organizer 활성화]

        현황 분석 중...

        📊 분석 결과:
        - 총 파일: 150개
        - 문서: 83개
        - 이미지: 67개

        🔍 발견된 패턴:
        1. WSOPTV 관련 문서 24개 (PRD, Executive Summary 등)
        2. EBS 관련 문서 4개
        3. 미분류 문서 55개

        📁 제안 폴더 구조:
        ├── WSOPTV/
        │   ├── prds/
        │   ├── strategy/
        │   └── analysis/
        ├── EBS/
        │   └── documents/
        └── Archive/

        이 구조로 정리할까요?

🧠 AI 분석 로직

1. 프로젝트 추론

파일명에서 프로젝트를 자동 추론합니다:

파일명 패턴추론 프로젝트
WSOPTV..., WSOP TV..., PRD-0002...WSOPTV
EBS..., PRD-0003...EBS
지지프로덕션..., 지지...지지프로덕션
브로드스튜디오..., 브로드...브로드스튜디오
개인 자료, 증명서, Meet 등_개인
위에 해당 없음_아카이브

2. 문서 유형 분류

파일명 키워드분류대상 폴더
PRD-, Product RequirementPRDprds/
Executive Summary, 요약경영 요약executive/
STRAT-, Strategy, 전략전략 문서strategy/
Analyze, 분석, Analysis분석 문서analysis/
Guide, 가이드, Tutorial가이드guides/
Test, 테스트, Draft임시 문서_archive/

3. 버전/중복 감지

패턴의미처리
v1, v2, v3명시적 버전최신만 유지, 나머지 archive
(사본), Copy of복사본원본 확인 후 archive
최종, Final, 완료최종본최신 취급
old, 이전, 백업구버전archive
동일 제목 + 다른 수정일암묵적 중복최신만 유지

📦 필요 인프라

Python 모듈

python
# 이미 존재하는 모듈 활용
from lib.google_docs.auth import get_credentials
from lib.google_docs.project_registry import ProjectRegistry, get_project_folder_id
from lib.google_docs.drive_organizer import DriveOrganizer

기존 CLI 명령

bash
# Drive 상태 확인
python -m lib.google_docs drive status

# 중복 파일 분석
python -m lib.google_docs drive duplicates

# 폴더 구조 생성
python -m lib.google_docs drive init

# 파일 정리
python -m lib.google_docs drive organize

🤖 에이전트 연동

이 스킬은 다음 에이전트와 연동됩니다:

에이전트역할사용 시점
analyst파일 목록 의미 분석Step 2
architect폴더 구조 설계Step 3
executor정리 작업 실행Step 4

🔧 실행 규칙 (Claude가 따라야 할 프로토콜)

Step 1: 현황 수집

python
# Drive 파일 목록 수집 (프로젝트별)
from lib.google_docs.auth import get_credentials
from lib.google_docs.project_registry import ProjectRegistry
from googleapiclient.discovery import build

creds = get_credentials()
drive = build('drive', 'v3', credentials=creds)
registry = ProjectRegistry()

# 각 프로젝트별 스캔
for project in registry.list_projects():
    folder_id = registry.get_folder_id(project)
    # 프로젝트 폴더 내 파일 수집
    query = f"'{folder_id}' in parents and trashed=false"
    results = drive.files().list(
        q=query,
        pageSize=200,
        fields='files(id, name, mimeType, modifiedTime, parents)'
    ).execute()

Step 2: AI 분석

수집된 파일 목록을 Claude가 직접 분석합니다:

  1. 프로젝트 그룹핑: 파일명에서 프로젝트 키워드 추출
  2. 유사 문서 그룹핑: 제목 유사도 비교 (Levenshtein distance 또는 의미적 유사성)
  3. 버전 관계 파악: v1/v2, 사본, 최종 등 패턴 감지
  4. 카테고리 분류: PRD, 전략, 분석, 가이드 등

Step 3: 계획 생성 및 사용자 확인

code
📁 정리 계획:

┌─────────────────────────────────────────────┐
│ 이동 계획 (15개 파일)                        │
├─────────────────────────────────────────────┤
│ WSOPTV/ (10개)                              │
│   ├─ prds/PRD-0002/ (2개)                   │
│   ├─ prds/PRD-0005/ (3개)                   │
│   ├─ prds/PRD-0006/ (1개)                   │
│   ├─ strategy/ (1개)                        │
│   ├─ executive/ (1개)                       │
│   └─ analysis/ (2개)                        │
│                                              │
│ _archive/ (5개)                              │
│   └─ _versions/ (중복/구버전)                │
└─────────────────────────────────────────────┘

계속 진행할까요? [Y/n]

Step 4: 실행

사용자 승인 후 Drive API로 실제 정리 실행:

python
# 폴더 생성
def create_folder(name, parent_id):
    # ...

# 파일 이동
def move_file(file_id, new_parent_id):
    # ...

⚠️ 주의사항

금지 행동

금지이유
❌ 사용자 확인 없이 파일 삭제데이터 손실 위험
❌ 원본 파일 직접 삭제Trash로 이동만 허용
❌ 공유 문서 권한 변경협업 방해
❌ 루트 폴더 구조 임의 변경사용자 승인 필수

필수 행동

필수설명
✅ 분석 결과 사용자 확인계획 실행 전 승인
✅ 실행 결과 리포트이동/아카이브된 파일 목록
✅ 롤백 가능성 안내Trash에서 복구 가능 안내
✅ 중요 파일 백업 권고대규모 정리 전

📊 출력 형식

분석 결과

code
============================================================
Google Drive Analysis Report
============================================================

📊 현황 요약
- 총 파일: 150개
- 문서: 83개 (Google Docs: 75, Sheets: 5, Slides: 3)
- 이미지: 67개 (PNG: 50, JPG: 17)
- 폴더: 12개

🔍 프로젝트 분류
| 프로젝트 | 문서 | 이미지 | 비고 |
|----------|------|--------|------|
| WSOPTV | 24개 | 3개 | PRD 5개, Executive 1개 |
| EBS | 4개 | 0개 | PRD 2개 |
| Archive | 55개 | 64개 | 미분류/레거시 |

⚠️ 발견된 문제
1. 중복 파일 12그룹 (30개 초과 파일)
2. 버전 관리 필요 문서 8개
3. 고아 폴더 3개 (빈 폴더)
4. 미분류 파일 55개

💡 추천 액션
1. /drive-organizer --dedupe : 중복 제거
2. /drive-organizer --archive-versions : 구버전 아카이브
3. /drive-organizer --restructure : 폴더 재구조화

실행 결과

code
============================================================
Google Drive Cleanup Complete
============================================================

✅ 완료된 작업
- 폴더 생성: 8개
- 파일 이동: 45개
- 버전 아카이브: 12개
- 빈 폴더 삭제: 3개

📁 최종 구조
WSOPTV/
├── documents/
│   ├── prds/ (6개)
│   ├── strategy/ (1개)
│   ├── executive/ (1개)
│   └── analysis/ (2개)
└── images/ (3개)

EBS/
└── documents/ (4개)

Archive/
├── documents/ (55개)
├── images/ (64개)
└── _versions/ (12개)

🔗 Drive: https://drive.google.com/drive/folders/1JwdlUe_v4Ug-yQ0veXTldFl6C24GH8hW

🔗 관련 스킬

스킬관계
google-workspace기반 인프라 (인증, API)
prd-syncPRD 문서 동기화

구조 감사 (Drive Guardian)

개요

drive_projects.yaml에 정의된 기대 구조와 실제 Drive 상태를 비교하여 위반 사항을 탐지하고 교정합니다.

거버넌스 정책 (YAML)

yaml
governance:
  root_policy:
    allowed_folders: [WSOPTV, EBS, ...]  # 루트 허용 폴더
    files_allowed: false                  # 루트 파일 금지
  required_subfolders: [documents, images]
  orphan_policy:
    auto_classify: true                   # 키워드 자동 분류
    fallback_folder: "_아카이브"           # 미분류 → 아카이브
  type_routing:
    "application/vnd.google-apps.document": "documents"
    "image/*": "images"

위반 심각도

심각도조건예시
CRITICAL루트에 파일/미허용 폴더 존재Root/report.pdf
WARNING필수 하위 폴더 누락EBS/images/ 없음
INFO프로젝트 루트에 미분류 파일WSOPTV/memo.doc

사용법

bash
# 감사만 (읽기 전용)
python -m lib.google_docs drive audit

# 감사 + 교정 계획 (dry-run)
python -m lib.google_docs drive audit --fix

# 감사 + 교정 실행
python -m lib.google_docs drive audit --fix --apply

# JSON 출력
python -m lib.google_docs drive audit --json

Python API

python
from lib.google_docs.drive_guardian import DriveGuardian

guardian = DriveGuardian()
report = guardian.audit()

if not report.is_clean:
    plan = guardian.generate_fix_plan(report)
    # dry-run으로 확인
    result = guardian.apply_fixes(plan, dry_run=True)
    # 실제 적용
    result = guardian.apply_fixes(plan, dry_run=False)

자동 트리거

다음 키워드로 자동 활성화됩니다:

  • "드라이브 감사", "폴더 점검", "구조 확인", "drive audit"

변경 로그

v2.1.0 (2026-02-06)

Drive Guardian 추가 (구조 거버넌스):

  • DriveGuardian 클래스: 감사 → 교정 계획 → 적용 파이프라인
  • drive_projects.yamlgovernance 섹션 추가
  • CLI drive audit 서브커맨드 추가 (--fix, --apply, --json)
  • 위반 심각도 분류: CRITICAL, WARNING, INFO
  • MIME type 기반 자동 라우팅 (type_routing)
  • 키워드 기반 프로젝트 자동 분류 (orphan_policy)

v2.0.0 (2026-02-06)

프로젝트 기반 구조 전환 (BREAKING CHANGE):

  • ProjectRegistry 기반 폴더 자동 감지
  • DEFAULT_FOLDER_ID → get_project_folder_id() 전환
  • 4개 프로젝트 지원: WSOPTV, EBS, 지지프로덕션, 브로드스튜디오
  • --project 옵션 추가 (특정 프로젝트만 정리)
  • _개인, _아카이브 특수 폴더 지원
  • DriveOrganizer 자동 프로젝트 감지 기능
  • 프로젝트별 폴더 구조 분리

v1.1.0 (2026-02-03)

Auto-Execute 기능 추가:

  • /drive 호출 시 자동 실행 프로토콜 추가
  • Step 1-5 자동화된 워크플로우
  • AskUserQuestion 기반 사용자 확인
  • 옵션별 분기 처리 (--analyze, --dedupe, --archive, --folder)

v1.0.0 (2026-02-03)

Initial Release:

  • AI 맥락 분석 기반 파일 분류
  • 프로젝트별 자동 그룹핑
  • 유사 문서 중복 감지
  • 버전 관리 자동화
  • 사용자 확인 기반 안전한 실행