Obsidian Add Content Skill

이 Skill은 Obsidian vault에 새로운 콘텐츠를 템플릿 기반으로 추가합니다.

Vault 경로

/Users/teamsparta/Library/Mobile Documents/iCloud~md~obsidian/Documents/for-dev

템플릿 경로

• •Information 템플릿: /Users/teamsparta/Library/Mobile Documents/iCloud~md~obsidian/Documents/for-dev/template/Information.md
• •Repository 템플릿: /Users/teamsparta/Library/Mobile Documents/iCloud~md~obsidian/Documents/for-dev/template/Repository.md
• •Code 템플릿: /Users/teamsparta/Library/Mobile Documents/iCloud~md~obsidian/Documents/for-dev/template/Code.md

사용 시나리오

1. Frontend 라이브러리/기능 추가

사용자 입력 예시:

• •"React의 useEffect 추가해줘"
• •"Next의 getServerSideProps 추가"
• •"Vanilla의 Event Delegation 추가"

동작:

1. •입력에서 라이브러리명(React/Next/Vanilla 등)과 기능명 추출
2. •Frontend/{라이브러리}/ 폴더 확인
   • •없으면: 폴더 생성 + {라이브러리}.md 폴더 노트 생성 (Information 템플릿)
   • •있으면: 기존 폴더 사용
3. •Frontend/{라이브러리}/{기능명}.md 생성 (Information 템플릿)
4. •Frontmatter 자동 설정:
   • •created-at: 오늘 날짜 (YYYY-MM-DD)
   • •tags: 자동 추천 (아래 로직 참고)
   • •color: 빈 문자열
5. •제목과 기본 섹션 구조 생성

2. Team Sparta 프로젝트 추가

사용자 입력 예시:

• •"모두AI 프로젝트 추가해줘"
• •"아카데미아 repo 추가"

동작:

1. •입력에서 프로젝트명 추출
2. •Team Sparta/repo/{프로젝트명}/ 폴더 생성
3. •Team Sparta/repo/{프로젝트명}/{프로젝트명}.md 생성 (Repository 템플릿)
4. •Frontmatter 자동 설정:
   • •created-at: 오늘 날짜
   • •tags: [team-sparta, project]
   • •color: 빈 문자열
   • •tech-stack: 빈 배열 (사용자가 채움)
   • •project-type: 빈 문자열 (사용자가 채움)
   • •description: 빈 문자열 (사용자가 채움)
5. •제목과 기본 섹션 구조 생성

3. Repo 코드 파일 추가

사용자 입력 예시:

• •"dev_proxy의 config 추가"
• •"모두AI의 utils 추가"
• •"/Users/teamsparta/repo/modoo-ai-frontend/src/features/product-tour 의 스켈레톤 만들어줘"

동작:

A. 단일 파일 추가 (간단한 입력)

1. •프로젝트 폴더 확인 (없으면 생성)
2. •{프로젝트}/{파일명}.md 생성 (Code 템플릿)
   • •frontmatter:
     • •created-at: 현재 날짜
     • •tags: [team-sparta, code]
     • •color: 빈 문자열
     • •file-path: 빈 문자열 (사용자가 채움)
     • •language: 입력에서 추론 (config.js → javascript, utils.py → python)
   • •제목: 파일명
   • •"## 코드" 섹션: 해당 언어의 빈 코드 블록 생성
3. •사용자가 "## 코드" 섹션에 실제 코드 작성
4. •코드 분석이나 설명 작성은 하지 않음 - 이는 obsidian-refine-content Skill의 역할

B. 디렉토리 구조 기반 스켈레톤 생성 (경로 입력)

사용자가 실제 파일 시스템 경로를 입력한 경우:

예시: /Users/teamsparta/repo/modoo-ai-frontend/src/features/product-tour

동작:

1. •

   경로 파싱:

   • •/Users/teamsparta/repo/ 이후의 경로 추출
   • •프로젝트명 식별: modoo-ai-frontend
   • •하위 경로 추출: src/features/product-tour
2. •

   프로젝트 폴더 생성:

   • •Team Sparta/repo/{프로젝트명}/ 폴더 생성
   • •{프로젝트명}.md 프로젝트 문서 생성 (Repository 템플릿)
3. •

   실제 디렉토리 구조 스캔:

   • •입력된 경로의 모든 소스 파일 탐색 (.ts, .tsx, .js, .jsx, .py 등)
   • •각 파일의 상대 경로 파악
4. •

   Obsidian 디렉토리 구조 재현:

   • •원본 프로젝트의 폴더 구조를 Obsidian vault에 완전히 동일하게 재현
   • •예시:
     code

     원본: /repo/modoo-ai-frontend/src/features/product-tour/contexts/context.ts
     생성: Team Sparta/repo/modoo-ai-frontend/src/features/product-tour/contexts/context.md
     
     원본: /repo/modoo-ai-frontend/src/features/product-tour/components/button.tsx
     생성: Team Sparta/repo/modoo-ai-frontend/src/features/product-tour/components/button.md
     

   • •중요: 전체 경로를 그대로 유지! src/features/product-tour/ 같은 중간 경로도 모두 포함
   • •실제 레포와 동일한 문서 구조를 만드는 것이 목표
5. •

   각 파일에 대해 Code 템플릿 기반 문서 생성:

   • •frontmatter:
     • •created-at: 현재 날짜
     • •tags: [team-sparta, code]
     • •file-path: 실제 파일의 절대 경로
     • •language: 파일 확장자에서 추론 (.tsx → tsx, .ts → typescript)
   • •제목: 파일명 (확장자 제외)
   • •"## 코드" 섹션: 실제 파일의 코드를 읽어서 삽입 (Read tool 사용)
6. •

   폴더별 그룹화:

   • •동일한 폴더의 파일들은 같은 Obsidian 하위 폴더에 생성
   • •예: contexts/, components/, hooks/, helpers/ 등

생성 예시:

Team Sparta/repo/modoo-ai-frontend/
├── modoo-ai-frontend.md (프로젝트 문서)
└── src/
    └── features/
        └── product-tour/
            ├── contexts/
            │   └── product-tour-context.md
            ├── constants/
            │   ├── product-tour-status.md
            │   └── product-tour-config.md
            ├── components/
            │   ├── product-tour.md
            │   └── tooltip/
            │       └── product-tour-tooltip.md
            ├── hooks/
            │   └── use-product-tour-handlers.md
            └── helpers/
                └── product-tour-cookie-helpers.md

코드 파일 예시:

# product-tour-context

## 개요


## 코드

\`\`\`typescript
// 실제 파일에서 읽어온 코드가 여기에 들어갑니다
import { createContext } from 'react';
...
\`\`\`

## 주요 함수/클래스


## 사용 방법

태그 자동 추천 로직

Frontend 파일의 태그 추천

기본 태그 (항상 포함):

• •front-end
• •라이브러리명을 소문자로 (예: react, next, vanilla-js)

추가 태그 (키워드 기반):

• •use로 시작하는 이름 (useEffect, useState 등) → hooks 추가
• •routing, router, route 포함 → routing 추가
• •form, input, validation 포함 → forms 추가
• •context, zustand, redux, state 포함 → state-management 추가
• •component 포함 → components 추가
• •seo, meta, head 포함 → seo 추가

기존 파일 참고:

• •같은 폴더의 기존 .md 파일들을 검색
• •공통 태그가 있으면 참고하여 추가

예시:

• •useEffect.md → tags: [front-end, react, hooks]
• •Hash Routing.md → tags: [front-end, vanilla-js, routing]
• •Controlled Form.md → tags: [front-end, react, forms]
• •Context Api.md → tags: [front-end, react, state-management]

Repository 파일의 태그 추천

기본 태그:

• •team-sparta
• •project

출력 형식

성공 시:

✅ 새 파일 생성 완료!

📁 경로: Frontend/React/useEffect.md
🏷️  태그: front-end, react, hooks

이제 파일을 열어서 내용을 작성하세요.
작성 후 `obsidian-refine-content` Skill로 정리/보완할 수 있습니다.

폴더도 생성한 경우:

✅ 새 라이브러리 폴더 및 파일 생성 완료!

📁 폴더: Frontend/Next/
📄 폴더 노트: Frontend/Next/Next.md
📄 기능 파일: Frontend/Next/getServerSideProps.md
🏷️  태그: front-end, next

이제 파일들을 열어서 내용을 작성하세요.

단일 코드 파일 추가 시:

✅ 코드 문서 생성 완료!

📄 파일: Team Sparta/repo/dev_proxy/config.md
🏷️  태그: team-sparta, code
💻 언어: javascript

이제 config.md를 열어서 "## 코드" 섹션에 코드를 작성하세요.
작성 후 `obsidian-refine-content` Skill로 코드 분석 및 설명이 자동 생성됩니다.

디렉토리 구조 기반 스켈레톤 생성 시:

✅ product-tour 스켈레톤 생성 완료!

📁 프로젝트 경로: Team Sparta/repo/modoo-ai-frontend/

생성된 파일 목록 (총 14개)

1. 프로젝트 문서
   - modoo-ai-frontend.md

2. src/features/product-tour/contexts/ (1개)
   - product-tour-context.md

3. src/features/product-tour/constants/ (2개)
   - product-tour-status.md
   - product-tour-config.md

4. src/features/product-tour/components/ (5개)
   - product-tour.md
   - tooltip/product-tour-tooltip.md
   ...

🏷️  태그: team-sparta, code
💻 전체 디렉토리 경로가 원본과 동일하게 유지됨

각 파일의 "## 코드" 섹션에 실제 코드를 작성한 후,
`obsidian-refine-content` Skill로 자동 분석 및 설명을 생성하세요.

예외 처리

1. •

   파일이 이미 존재하는 경우:

   • •메시지: "⚠️ 파일이 이미 존재합니다: {경로}. 덮어쓰시겠습니까?"
   • •사용자 확인 후 진행
2. •

   라이브러리명/프로젝트명을 파싱할 수 없는 경우:

   • •사용자에게 명확한 입력 요청
   • •예: "라이브러리명과 기능명을 명확히 입력해주세요. 예: 'React의 useEffect 추가'"
3. •

   업무일지 폴더에 추가하려는 경우:

   • •메시지: "❌ 업무일지 폴더는 자동 생성 대상이 아닙니다. 수동으로 작성해주세요."

중요 지시사항

1. •날짜 형식: created-at은 항상 YYYY-MM-DD 형식 (예: 2025-12-18)
2. •태그 형식: 배열 형식, kebab-case 사용 (예: front-end, state-management)
3. •파일명: 사용자 입력 그대로 사용, 공백 포함 가능 (예: Context Api.md, Hash Routing.md)
4. •폴더 노트: 라이브러리 폴더 생성 시 폴더 노트도 함께 생성
5. •템플릿 정확히 따르기: Information, Repository, Code 템플릿의 구조를 정확히 따라야 함
6. •Code 템플릿 사용 시:
   • •.md 파일만 생성 (실제 코드 파일은 만들지 않음)
   • •"## 코드" 섹션에 빈 코드 블록 생성
   • •언어는 사용자 입력에서 추론 (config.js → javascript)
   • •코드 분석/설명은 작성하지 않음 (Skill 2의 역할)

작업 순서

A. 단일 파일 추가

1. •사용자 입력 파싱
2. •대상 경로 결정
3. •폴더 존재 확인 → 필요시 생성
4. •템플릿 파일 읽기
5. •태그 자동 추천
6. •새 파일 생성 (템플릿 + 메타데이터)
7. •성공 메시지 출력

B. 디렉토리 스켈레톤 생성 (경로 입력 시)

1. •입력된 실제 파일 시스템 경로 파싱
2. •프로젝트명 추출 (/Users/teamsparta/repo/ 이후 첫 번째 폴더)
3. •프로젝트 폴더 및 문서 생성 (Team Sparta/repo/{프로젝트명}/)
4. •입력된 경로의 모든 소스 파일 스캔 (.ts, .tsx, .js, .jsx 등)
5. •각 파일의 전체 상대 경로 추출 (예: src/features/product-tour/contexts/context.ts)
6. •Obsidian vault에 전체 경로를 동일하게 재현:
   • •Team Sparta/repo/{프로젝트명}/src/features/product-tour/contexts/context.md
   • •모든 중간 폴더 생성 필요
7. •각 파일에 대해 Code 템플릿 기반 문서 생성:
   • •file-path에 원본 파일의 절대 경로 기록
   • •language는 확장자에서 자동 추론
   • •Read tool로 실제 파일 내용 읽기
   • •읽은 코드를 "## 코드" 섹션에 삽입
8. •성공 메시지 출력 (생성된 파일 개수 및 경로 구조 표시)