jasoseo-plugin

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 21 Open GitHub ↗

한국 취업 자기소개서를 기업조사→초안→글자수→리뷰→윤문→검증 8단계로 완성하는 Claude Code 플러그인

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# jasoseo — 자기소개서 작성 파이프라인 (Claude Code 플러그인)

> 회사 하나 조사하고, 문항 뜯어보고, 초안 쓰고, 글자 수 맞추고, 검토하고, 다듬고, 다시 확인하고… 자소서 한 편에 드는 이 반복을 8단계로 정리해 자동으로 돌려주는 Claude Code 플러그인입니다. 특히 **여러 회사에 동시에 지원하는** 신입·인턴 지원자를 위해 만들었습니다.

## 이 플러그인이 대신 해주는 일

여러 회사에 지원하다 보면 매번 똑같은 실수가 반복됩니다. jasoseo는 그걸 막아줍니다.

- **소재 중복** — 같은 프로젝트·같은 수치를 이 문항 저 문항에 또 쓰는 걸 자동으로 잡아냅니다 (같은 숫자가 두 번 나오면 "소재가 부족한 사람"으로 읽힙니다).
- **경험 과장·거짓** — 이력서에 없는 성과, 팀 프로젝트에서 내가 안 한 부분을 "내가 했다"고 쓰는 걸 사실 대조로 걸러냅니다.
- **글자 수 미달/초과** — 문항마다 Python으로 실측해서 제한의 95%를 정확히 채웁니다.
- **회사별 파일 정리** — 회사마다 폴더를 만들고, 폴더 이름에 마감일을 붙여 뭐가 급한지 한눈에 보이게 합니다.

**대신, 못 하는 것도 분명히 말씀드립니다:** 실제 지원 폼에 자동 제출은 하지 않습니다(최종 검토·제출은 본인 몫). 그리고 글자 수 기준이 "공백 포함이냐 제외냐"는 공고에 안 적힌 경우가 많아, 제출 전 지원 폼에서 한 번 확인하시라고 항상 안내합니다.

## 시작하기 전에

- **Claude Code**가 설치되어 있어야 합니다. ([설치 안내](https://docs.claude.com/en/docs/claude-code))
- 본인 **이력서**를 텍스트로 정리해 둔 파일이 필요합니다 (아래에서 설명).

## 설치 (3분)

**1단계 — 플러그인 설치**

GitHub에서 설치 (권장):

```
/plugin marketplace add KangRyun/jasoseo-plugin
/plugin install jasoseo@jasoseo-marketplace
```

직접 클론해서 로컬로 써보려면 (내려받은 폴더 경로를 그대로 사용):

```
/plugin marketplace add ./jasoseo-plugin
/plugin install jasoseo@jasoseo-marketplace
```

**2단계 — 작업 폴더 준비**

지원 준비를 모아둘 폴더(예: `~/취업준비`)를 하나 만들고, 그 안에서 Claude Code를 실행합니다. 이 폴더에 아래 두 파일을 둡니다.

| 파일 | 필수? | 무엇을 담나 |
|---|---|---|
| `이력서.md` | **필수** | 학력·경력·프로젝트·수상·스킬 등 **사실**. 자소서의 모든 소재는 여기서만 가져옵니다. 여기 없는 건 자소서에 안 씁니다. |
| `PROFILE.md` | 선택(권장) | 이력서엔 안 적었지만 자소서엔 쓸 수 있는 것 — 예: "이 프로젝트의 A기능은 팀원이 한 거라 내 성과로 쓰면 안 됨", "여러 회사에 반복해서 쓸 나만의 핵심 컨셉" 등. |

`이력서.md`가 어떤 모습이어야 할지 감이 안 오면, 그냥 이력서 내용을 마크다운으로 편하게 적어두면 됩니다(항목별 제목 + 내용). `PROFILE.md`는 [템플릿](skills/jasoseo/references/profile-template.md)을 복사해 채우세요 — 비워둬도 동작하고, 진행하면서 알게 된 사실이 계속 쌓입니다.

## 사용법

작업 폴더에서 Claude Code를 켜고, **회사명과 직무를 함께** 입력합니다:

```
/jasoseo 삼성전자 데이터엔지니어
```

회사명과 직무는 **둘 다 필수**입니다. 같은 회사라도 직무가 다르면(데이터엔지니어 / 반도체 공정 / 영업) 자소서가 완전히 달라지기 때문입니다. 직무 없이 회사명만 입력하면 Claude가 먼저 직무를 물어본 뒤 진행합니다. 이어서 채용 공고(링크나 이미지)·문항·마감일도 물어보고 8단계를 시작합니다.

특정 단계부터 이어가고 싶으면 맨 끝에 단계 이름을 붙입니다:

```
/jasoseo 삼성전자 데이터엔지니어 리뷰      # 이미 초안이 있고, 전문가 리뷰부터
```

## Codex(OpenAI)에서 쓰기

이 플러그인의 **설치 명령(`/plugin ...`)은 Claude Code 전용**이라 Codex에선 동작하지 않습니다. 하지만 파이프라인 본체는 표준 `SKILL.md`라, Codex의 **Skills** 기능으로 그대로 옮겨 쓸 수 있습니다 (Codex도 `SKILL.md` + `name`/`description` frontmatter 포맷을 씁니다).

**설치 — 스킬 폴더만 복사하면 됩니다.**

```bash
# 전역(어디서나 사용): ~/.agents/skills/  ·  특정 저장소에서만: <repo>/.agents/skills/
git clone https://github.com/KangRyun/jasoseo-plugin.git
mkdir -p ~/.agents/skills
cp -r jasoseo-plugin/skills/jasoseo ~/.agents/skills/jasoseo
```

**사용** — Codex를 작업 폴더(이력서.md가 있는 곳)에서 실행하고, 자연어로 부르면 됩니다:

```
jasoseo로 삼성전자 데이터엔지니어 자소서 초안 잡아줘
```

Codex에는 이 저장소의 서브에이전트(researcher·reviewer)가 등록되진 않지만, `SKILL.md`가 그 역할 정의(`agents/*.md`)를 따라 조사·리뷰 단계를 **직접 수행**하도록 쓰여 있어 결과는 동일하게 나옵니다. 두 역할을 Codex 서브에이전트로 따로 등록하면 더 깔끔하게 분리 실행할 수도 있습니다.

> 참고: Codex의 Skills/경로는 [공식 문서](https://learn.chatgpt.com/docs/customization/overview)를 따릅니다. 버전에 따라 경로가 바뀔 수 있으니, 위 `~/.agents/skills` 가 안 먹으면 문서에서 현행 위치를 확인하세요.

## 8단계, 이렇게 진행됩니다

| 단계 | 하는 일 | 나오는 파일 |
|---|---|---|
| 1. 기업 조사 | 미션·인재상·사업·최근 실적 조사 + 내 경험과의 연결 전략 | `기업조사_<회사>.md` |
| 2. 공고·문항 분석 | 문항이 **실제로 뭘 묻는지** 분해 (복합 질문이면 하위 질문까지) | `자기소개.md` |
| 3. 초안 작성 | 문항별 소제목 + 본문, 컨셉 한 줄로 관통 | `자기소개서_초안.md` |
| 4. 글자 수 조정 | 제한의 95%로 실측 + 소재 중복 자가진단 | (초안 갱신) |
| 5. 전문가 리뷰 | 인사담당자 관점 5축 평가(사실·직무·문항충실·차별성·표현) | `리뷰_리포트.md` |
| 6. 리뷰 반영 | 치명 이슈 전부·권장 대부분 반영 | (초안 갱신) |
| 7. 윤문 | AI 티 나는 문장을 자연스러운 한국어로 (수치·고유명사는 불변) | `자기소개서_윤문.md` ← **제출용 최종본** |
| 8. 최종 검증 | 글자 수·핵심 수치가 실제로 보존됐는지 직접 재확인 | (기록 갱신) |

각 회사 폴더는 `<회사명>_마감0930`처럼 **마감일이 이름에 붙어** 생성되므로, 폴더 목록만 봐도 무엇부터 써야 할지 보입니다. 마감일이 없는 상시채용은 `<회사명>_수시`가 됩니다.

## 여러 회사 한꺼번에

"이번 주에 5개 회사 마감이야" 같은 상황이면, Claude에게 여러 회사를 한 번에 맡길 수 있습니다. 회사별로 파이프라인이 병렬로 돌아가고, 각자 자기 폴더에만 파일을 쓰기 때문에 서로 안 엉킵니다. 그냥 자연어로 "이 회사들 자소서 다 써줘"라고 하고 회사 목록을 주면 됩니다.

## 함께 쓰면 좋은 플러그인

7단계(윤문)에서 [`humanize-korean`](https://github.com/epoko77-ai/im-not-ai) 플러그인이 설치돼 있으면 자동으로 활용해 "AI가 쓴 티"를 더 잘 지웁니다. 없어도 자체 윤문으로 대체되니 필수는 아닙니다.

## 자주 묻는 질문

**Q. 이력서가 PDF밖에 없어요.**
A. PDF도 읽을 수 있지만, 마크다운(`이력서.md`)으로 정리해두면 훨씬 정확합니다. "이 PDF를 이력서.md로 정리해줘"라고 먼저 부탁하셔도 됩니다.

**Q. 없는 경력을 그럴듯하게 지어내 주나요?**
A. 아니요. 그게 이 플러그인의 첫 번째 원칙입니다 — 이력서에 있는 사실만 씁니다. 부족한 역량은 숨기기보다 "빠르게 배우겠다"는 식으로 정직하게 처리하도록 설계돼 있습니다.

**Q. 글자 수가 공백 포함인지 제외인지 모르겠어요.**
A. 공고에 없으면 플러그인이 알려드리고, 제출 폼에서 직접 확인하시라고 안내합니다. 대부분 공백 포함 기준으로 맞춰두되 제출 전 확인이 필요합니다.

**Q. `/jasoseo`가 반응을 안 해요.**
A. 플러그인이 활성(enabled) 상태인지 `/plugin` 메뉴에서 확인하세요. 같은 이름의 개인 스킬이 따로 있으면 충돌할 수 있습니다.

**Q. 회사명만 넣으면 안 되나요?**
A. 됩니다 — 그러면 Claude가 직무를 되물어봅니다. 다만 처음부터 `회사명 직무` 를 같이 넣으면 한 번 덜 묻고 바로 시작합니다.

## 구성

```
jasoseo/
├── skills/jasoseo/            # 8단계 파이프라인 (오케스트레이션)
│   └── references/profile-template.md
└── agents/
    ├── jasoseo-researcher.md  # 1단계 기업 조사 전용
    └── jasoseo-reviewer.md    # 5단계 전문가 리뷰 전용
```

## 라이선스

MIT

jasoseo-plugin

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README