메뉴
마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | polish-file |
| argument-hint | <파일경로> [--threshold=9.5] [--resume] [--report-only] |
| description | 마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다. |
마크다운 파일의 문장을 분석하고, 기준 점수 미만 문장을 순차적으로 개선합니다. 번역 파일이면 원문도 함께 확인합니다.
Codex에서는 .agents/agents/polish-agent.md의 역할 프롬프트를 참고해 직접 분석합니다. 사용자가 명시적으로 하위 에이전트나 병렬 작업을 요청한 경우에만 Codex sub-agent를 사용합니다.
.agents/agents/polish-agent.md.agents/skills/translate-writer/references/translation-patterns.md.agents/skills/polish-file/references/report-schema.md.agents/skills/polish-file/references/output-templates.md.agents/skills/polish/references/ask-user-templates.md.agents/polish-reports/| 옵션 | 설명 | 기본값 |
|---|---|---|
--threshold=X.X | 기준 점수, 미만 문장만 개선 대상 | 9.5 |
--resume | 이전 분석 리포트에서 이어서 진행 | false |
--report-only | JSON 리포트만 생성하고 개선하지 않음 | false |
다음 조건 중 하나라도 해당하면 번역 파일로 봅니다.
translation/ 포함tags: ["translation"] 포함번역 파일이면 본문 초반에서 원본 URL을 찾습니다.
\[([^\]]+)\]\((https?://[^)]+)\).*번역
원본 URL이 있으면 웹 조회로 전체 본문을 마크다운 형식으로 추출합니다. 접근에 실패하면 원문 없이 일반 문장 분석으로 진행합니다.
각 문장에 대해 .agents/agents/polish-agent.md 기준으로 점수, 발견 패턴, 개선 옵션, 원문 의미 보존 여부를 산정합니다.
결과는 다음 구조의 JSON 리포트로 정리합니다.
{
"file": "contents/blog/example/index.md",
"threshold": 9.5,
"average_score": 9.2,
"sentences": [
{
"line": 42,
"original": "문장",
"source": "source sentence if available",
"score": 8.7,
"patterns_found": ["#1"],
"status": "pending",
"options": []
}
]
}
리포트는 .agents/polish-reports/[slug]-[timestamp].json에 저장합니다. --report-only가 있으면 여기서 종료합니다.
✋ GATE 1: 게이트에서는 사용자 확인 없이 Step 5로 진행하지 마세요 (--report-only 제외).
전체 문장 수, 평균 점수, 기준 미만 문장 수를 보여주고 지금 다듬을지, 리포트만 둘지, 취소할지 확인합니다.
기준 점수 미만 문장에 대해 /polish 스킬 흐름을 적용합니다.
status와 선택 결과를 갱신합니다.마크다운 파일 전체의 문장 품질을 분석하고 점수별 개선을 제안하는 스킬. 번역 파일이면 원본 URL에서 영어 원문을 가져와 의미 보존까지 검증합니다. "파일 전체 다듬기", "글 품질 점검", "문장별 분석", "번역 품질 검사", "polish file", "파일 리뷰" 등의 요청에 사용하세요. 개별 문장이 아닌 파일 전체를 대상으로 할 때 /polish 대신 이 스킬을 사용합니다.
영어 기술 블로그/문서를 고품질 한국어 블로그 포스트로 변환하는 전문 번역 파이프라인. 이 스킬은 단순히 텍스트를 번역하는 것이 아니라, 저자의 스타일을 학습하고 6개 전문 에이전트(번역기, 번역투 리뷰어, 원문 충실도 검증기, 문장 polish 등)가 협업하여 출판 수준의 번역을 생성합니다. 사용자가 영어 글을 번역하거나 한국어로 옮기고 싶다고 하면 반드시 이 스킬을 사용하세요. URL이나 파일 경로를 주며 번역을 요청하는 경우, "번역해줘", "한국어로", "translate", "번역 블로그", "옮겨줘", "영어 글" 등의 키워드가 포함된 경우 모두 해당합니다. 직접 번역하지 말고 반드시 이 스킬을 호출하세요 — 직접 번역은 스타일 가이드, 용어집, 이중 검증을 활용할 수 없어 품질이 크게 떨어집니다.
저자의 스타일을 학습하여 한국어 블로그 글을 작성하는 파이프라인. 스타일 분석, 초안 작성, 80점 기준 검토 루프, 사용자 승인까지 수행합니다. "글 써줘", "블로그 작성", "포스트 생성", "write a blog post", "새 글 쓰기" 등의 요청에 사용하세요. 번역이 아닌 원본 한국어 글을 쓸 때 /translate-writer 대신 이 스킬을 사용합니다.
개별 문장을 분석하고 3-4개 개선 옵션을 점수와 함께 제시하는 문장 다듬기 스킬. 번역 파일이면 원본 영어 문장을 찾아 의미 보존 여부까지 검증합니다. "이 문장 다듬어줘", "자연스럽게 고쳐줘", "문장 개선", "polish this sentence", "번역투 수정" 등의 요청에 사용하세요. 파일 전체가 아닌 특정 문장 1-2개를 다듬을 때 /polish-file 대신 이 스킬을 사용합니다.
영어 기술 블로그/문서를 고품질 한국어 블로그 포스트로 변환하는 전문 번역 파이프라인. 스타일 가이드, 용어집, 한국어 품질 검토, 원문 충실도 검증, 문장 polish를 함께 사용합니다. URL이나 파일 경로를 주며 "번역해줘", "한국어로", "translate", "번역 블로그", "옮겨줘", "영어 글" 등을 요청하면 반드시 이 스킬을 사용하세요.
저자의 스타일을 학습하여 한국어 블로그 글을 자동 작성하는 4-에이전트 파이프라인. 스타일 분석, 초안 작성, 검토 루프(80점 기준), 사용자 승인까지 자동 수행. "글 써줘", "블로그 작성", "포스트 생성", "write a blog post", "새 글 쓰기" 등의 요청에 사용하세요. 번역이 아닌 원본 한국어 글을 쓸 때 /translate-writer 대신 이 스킬을 사용합니다.