菜单
마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
영어 기술 블로그/문서를 고품질 한국어 블로그 포스트로 변환하는 전문 번역 파이프라인. 이 스킬은 단순히 텍스트를 번역하는 것이 아니라, 저자의 스타일을 학습하고 6개 전문 에이전트(번역기, 번역투 리뷰어, 원문 충실도 검증기, 문장 polish 등)가 협업하여 출판 수준의 번역을 생성합니다. 사용자가 영어 글을 번역하거나 한국어로 옮기고 싶다고 하면 반드시 이 스킬을 사용하세요. URL이나 파일 경로를 주며 번역을 요청하는 경우, "번역해줘", "한국어로", "translate", "번역 블로그", "옮겨줘", "영어 글" 등의 키워드가 포함된 경우 모두 해당합니다. 직접 번역하지 말고 반드시 이 스킬을 호출하세요 — 직접 번역은 스타일 가이드, 용어집, 이중 검증을 활용할 수 없어 품질이 크게 떨어집니다.
저자의 스타일을 학습하여 한국어 블로그 글을 작성하는 파이프라인. 스타일 분석, 초안 작성, 80점 기준 검토 루프, 사용자 승인까지 수행합니다. "글 써줘", "블로그 작성", "포스트 생성", "write a blog post", "새 글 쓰기" 등의 요청에 사용하세요. 번역이 아닌 원본 한국어 글을 쓸 때 /translate-writer 대신 이 스킬을 사용합니다.
마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다.
개별 문장을 분석하고 3-4개 개선 옵션을 점수와 함께 제시하는 문장 다듬기 스킬. 번역 파일이면 원본 영어 문장을 찾아 의미 보존 여부까지 검증합니다. "이 문장 다듬어줘", "자연스럽게 고쳐줘", "문장 개선", "polish this sentence", "번역투 수정" 등의 요청에 사용하세요. 파일 전체가 아닌 특정 문장 1-2개를 다듬을 때 /polish-file 대신 이 스킬을 사용합니다.
영어 기술 블로그/문서를 고품질 한국어 블로그 포스트로 변환하는 전문 번역 파이프라인. 스타일 가이드, 용어집, 한국어 품질 검토, 원문 충실도 검증, 문장 polish를 함께 사용합니다. URL이나 파일 경로를 주며 "번역해줘", "한국어로", "translate", "번역 블로그", "옮겨줘", "영어 글" 등을 요청하면 반드시 이 스킬을 사용하세요.
저자의 스타일을 학습하여 한국어 블로그 글을 자동 작성하는 4-에이전트 파이프라인. 스타일 분석, 초안 작성, 검토 루프(80점 기준), 사용자 승인까지 자동 수행. "글 써줘", "블로그 작성", "포스트 생성", "write a blog post", "새 글 쓰기" 등의 요청에 사용하세요. 번역이 아닌 원본 한국어 글을 쓸 때 /translate-writer 대신 이 스킬을 사용합니다.
| name | polish-file |
| description | 마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다. |
| argument-hint | <파일경로> [--threshold=9.5] [--resume] [--report-only] |
| allowed-tools | ["Read","Write","Bash","Glob","Task","AskUserQuestion","Edit","WebFetch"] |
마크다운 파일의 모든 문장을 분석하고, 기준 점수 미만 문장들을 순차적으로 개선합니다. 번역 파일인 경우 원본 글을 가져와 각 문장의 원문과 함께 분석합니다.
/polish-file <파일>
→ Step 0: 원본 감지 (번역 파일이면 WebFetch로 영어 원문 가져오기)
→ Step 1: 파일 읽기 + 문장 추출 (frontmatter/코드블록 제외, 번역 시 원문 매칭)
→ Step 2: polish-agent batch 호출 (문장별 점수 + 패턴 분석)
→ Step 3: JSON 리포트 생성 (.claude/polish-reports/)
→ Step 4: 사용자 확인 ("N개 문장 다듬기 진행?")
→ Step 5: 순차 개선 (옵션 제시 → 선택 → Edit 적용)
대상 파일: $ARGUMENTS
| 옵션 | 설명 | 기본값 |
|---|---|---|
--threshold=X.X | 기준 점수 (미만 문장만 개선 대상) | 9.5 |
--resume | 이전 분석에서 이어서 진행 | false |
--report-only | JSON 리포트만 생성 (개선 없음) | false |
다음 조건 중 하나라도 해당하면 번역 파일:
translation/ 포함tags: ["translation"] 포함번역 파일의 본문 시작 부분에서 원본 URL 패턴을 찾습니다:
> 이 문서는 ... ["제목"](URL)의 한글 번역입니다.
정규식 패턴:
\[([^\]]+)\]\((https?://[^)]+)\).*번역
WebFetch 도구로 원본 URL의 내용을 가져옵니다:
WebFetch(url=원본URL, prompt="전체 본문 텍스트를 마크다운 형식으로 추출해주세요. 각 문단과 문장을 명확히 구분해주세요.")
원본 콘텐츠를 문장 단위로 분리하여 리스트로 저장:
{
"source_url": "https://...",
"source_sentences": [
{"index": 0, "section": "Introduction", "text": "..."},
{"index": 1, "section": "Introduction", "text": "..."},
...
]
}
...)이나 링크 내부는 분리하지 않음각 문장에 대해 Task 도구로 호출 (subagent_type: "polish-agent"):
번역 파일인 경우 (원문 포함):
문장: "[추출된 문장]"
원본: "[매칭된 영어 원문]"
모드: "batch"
일반 파일인 경우:
문장: "[추출된 문장]"
모드: "batch"
반환값 (JSON):
{
"original": "...",
"source": "[영어 원문 - 번역 파일인 경우]",
"score": 9.3,
"source_validation": {
"meaning_preserved": true,
"issues": []
},
"patterns_found": ["#1", "#8"],
"options": [...]
}
리포트를 .claude/polish-reports/[slug]-[timestamp].json에 저장합니다.
스키마 상세: @.claude/skills/polish-file/references/report-schema.md
✋ GATE 1 — AskUserQuestion: 게이트에서는 AskUserQuestion 호출 없이 Step 5로 진행하지 마세요 (--report-only 제외).
AskUserQuestion으로 질문:
## 파일 분석 완료
**파일**: [파일명]
**전체 문장**: N개
**평균 점수**: X.X/10
**개선 대상** (< 9.5점): M개
진행 방법을 선택하세요:
1. ✅ 지금 다듬기 - M개 문장 순차 개선
2. 📄 리포트만 저장 - 나중에 /polish-file --resume로 이어서
3. ❌ 취소
기준 점수 미만 문장들에 대해, /polish 스킬의 Step 1-3 로직을 따라 순차적으로 개선합니다:
[3/12] Line 67/polish 스킬과 동일한 흐름 실행:
/polish 스킬 참조)옵션 포맷 상세: @.claude/skills/polish/references/ask-user-templates.md
이전 분석을 이어서 진행:
가장 최근 JSON 리포트 파일 찾기
ls -t .claude/polish-reports/[slug]-*.json | head -1
리포트에서 status: "pending" 문장부터 시작
이미 완료된 항목 건너뛰기
진행 중/완료 출력 템플릿: @.claude/skills/polish-file/references/output-templates.md
translate-writer의 Phase 3에서 이 스킬을 호출합니다:
Phase 2 완료 (translation-reviewer 통과)
│
▼
Phase 3: polish-file 호출
- --threshold에 따른 문장 필터링
- 사용자 확인 후 개선
│
▼
Phase 4: 최종 승인
.claude/agents/polish-agent.md.claude/skills/translate-writer/references/translation-patterns.md.claude/polish-reports/