Skip to content

refactor(.claude/skills): Skill 문서 중복 제거 및 구조 개선#722

Merged
jk-kim0 merged 10 commits intomainfrom
jk/skill-reorganize
Feb 14, 2026
Merged

refactor(.claude/skills): Skill 문서 중복 제거 및 구조 개선#722
jk-kim0 merged 10 commits intomainfrom
jk/skill-reorganize

Conversation

@jk-kim0
Copy link
Copy Markdown
Contributor

@jk-kim0 jk-kim0 commented Feb 14, 2026

Summary

Skill 문서 간 중복되는 내용을 제거하고, 각 skill의 역할에 맞게 구조를 정리합니다.

  • .claude/commands/의 commit.md, proofread.md를 .claude/skills/로 통합합니다.
  • CLAUDE.md를 추가하여 프로젝트 컨텍스트와 skill 위치를 자동 탐색할 수 있게 합니다.
  • translation.md를 번역 규칙의 단일 원본(single source of truth)으로 지정하고, 중복 내용을 참조로 대체합니다.
  • documentation.md를 삭제하고 유의미한 MDX 문법 참조를 translation.md로 이동합니다.
  • skeleton 비교, 빌드 검증 등 중복 섹션을 각 전용 skill 참조로 간소화합니다.
  • skill 간 참조 경로를 상대경로로 통일합니다.
  • reverse-sync.mdxhtml-beautify-diff.md 상호 참조를 명확화합니다.
  • code-review.md에서 TypeScript/React 및 일반 리뷰 원칙을 제거하고 프로젝트 특화 내용만 유지합니다 (201줄 → 48줄).
  • README 카테고리를 실제 성격에 맞게 6개로 재분류합니다.
  • Co-Authored-By 버전을 Claude Opus 4.6으로 업데이트합니다.

Test plan

  • skill 파일 간 상호 참조 링크가 올바른지 확인
  • 빌드에 영향 없음 확인 (.claude/skills/는 빌드 대상 아님)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 noreply@anthropic.com

@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 14, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Canceled Canceled Comment Feb 14, 2026 10:23am

Request Review

@jk-kim0 jk-kim0 self-assigned this Feb 14, 2026
@jk-kim0 jk-kim0 force-pushed the jk/skill-reorganize branch from 51ad336 to 30f3b2c Compare February 14, 2026 10:15
jk-kim0 and others added 10 commits February 14, 2026 19:20
## Summary
Claude가 프로젝트 컨텍스트와 skill을 자동으로 인식할 수 있도록 정리합니다.

- .claude/commands/ 의 commit.md, proofread.md를 .claude/skills/로 이동합니다.
- .claude/commands/ 디렉토리를 삭제합니다.
- skills README.md에 프로세스 Skills 섹션을 추가합니다.
- 프로젝트 루트에 CLAUDE.md를 생성하여 컨벤션과 skill 위치를 명시합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
… 대체합니다

- confluence-pr-update.md Step 5의 상세 설명을 mdx-skeleton-comparison.md 참조로 간소화합니다.
- confluence-pr-update.md의 Skeleton 불일치 트러블슈팅을 참조로 대체합니다.
- sync-ko-to-en-ja.md Step 5에 mdx-skeleton-comparison.md 참조를 추가합니다.
- Co-Authored-By 버전을 4.6으로 업데이트합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- "문서 작성/개발/프로세스" 3분류를 6개 카테고리로 세분화합니다.
  - 번역/교정, Confluence 워크플로우, Reverse Sync/XHTML, 문서 작성, 유틸리티, 프로세스
- 누락된 confluence-mdx-testcase.md를 추가합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…가이드를 제외합니다

- translation.md에 CI Pipeline 검증 안내를 보강합니다.
- proofread.md의 빌드 검증 섹션을 translation.md 참조로 대체합니다.
- code-review.md에서 TypeScript/React 관련 섹션을 제거하고 MDX/문서 중심으로 정리합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
….md로 이동합니다

- documentation.md의 MDX 문법 참조(frontmatter, Callout, figure, table, 링크)를 translation.md에 추가합니다.
- 다른 skill과 중복되거나 프로젝트 실제 구조와 맞지 않는 내용은 제거합니다.
- README.md에서 documentation.md 항목과 참조를 제거합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- skill → skill 참조를 상대경로 (xxx.md)로 통일합니다.
- skill → 외부 문서 참조는 프로젝트 루트 절대경로 (/docs/xxx.md)를 유지합니다.
- translation.md의 비정상 경로 (/docs/../.claude/skills/)를 수정합니다.
- confluence-pr-update.md의 중복 번역 참조를 한 줄로 통합합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…화합니다

- reverse-sync.md의 관련 Skill 항목을 링크로 변환합니다.
- xhtml-beautify-diff.md에 관련 Skill 섹션을 추가하여 reverse-sync.md 역참조를 명시합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- 일반적인 코드 리뷰 원칙(피드백 유형, 모범 사례, 승인 기준 등)을 제거합니다.
- MDX 문서, 다국어 일관성, 빌드/배포 등 프로젝트 고유 검토 항목만 유지합니다.
- 201줄에서 48줄로 축소합니다.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jk-kim0 jk-kim0 force-pushed the jk/skill-reorganize branch from 45269c4 to 126bb27 Compare February 14, 2026 10:21
@jk-kim0 jk-kim0 merged commit 0b62cde into main Feb 14, 2026
3 of 5 checks passed
@jk-kim0 jk-kim0 deleted the jk/skill-reorganize branch February 14, 2026 10:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant