53 lines
1.3 KiB
Markdown
53 lines
1.3 KiB
Markdown
# Common Skills
|
|
|
|
이 폴더는 팀 공통으로 사용할 Claude **skill** 들을 모아두는 공간입니다.
|
|
각 프로젝트는 submodule 로 이 저장소를 가져온 뒤, `.claude/common/skills/*` 를
|
|
`.claude/skills/*` 로 **심볼릭 링크**하여 사용합니다.
|
|
|
|
## Skill 구조
|
|
|
|
각 skill 은 하나의 폴더이며, 루트에 `SKILL.md` 를 가집니다.
|
|
|
|
```
|
|
skills/
|
|
└── <skill-name>/
|
|
├── SKILL.md # YAML frontmatter (name, description) + 지시문
|
|
└── (선택) 추가 자료 — 예시 파일, 템플릿, 스크립트 등
|
|
```
|
|
|
|
`SKILL.md` 예시:
|
|
|
|
```markdown
|
|
---
|
|
name: <skill-name>
|
|
description: <Claude 가 이 skill 을 언제 써야 하는지 한 줄로>
|
|
---
|
|
|
|
# <스킬 제목>
|
|
|
|
## 언제 사용하는가
|
|
...
|
|
|
|
## 작업 순서
|
|
...
|
|
```
|
|
|
|
## 프로젝트에 연결하기
|
|
|
|
```bash
|
|
# 공통 저장소의 skill 을 .claude/skills/ 로 전부 링크
|
|
bash .claude/common/scripts/link-skills.sh
|
|
|
|
# 차이 확인
|
|
bash .claude/common/scripts/link-skills.sh --dry-run
|
|
|
|
# 특정 skill 만 링크
|
|
bash .claude/common/scripts/link-skills.sh vue-component-review
|
|
```
|
|
|
|
## 새 skill 추가 프로세스
|
|
|
|
1. 이 저장소에서 `skills/<skill-name>/SKILL.md` 를 작성
|
|
2. PR 을 올리고 팀 리뷰
|
|
3. 머지 후 각 프로젝트에서 `git submodule update --remote` → `link-skills.sh` 실행
|