DongHyeonkaandClaude Opus 5
1099834617
미추적 파일과 미커밋 수정을 전부 담아 pre-harness-removal 태그의 복구 범위를 확보한다. .agents/skills/writing-natural-korean 9개와 korean-technical-blog-skills-bundle-v1 61개가 여기 포함된다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
89 lines
3.2 KiB
Markdown
89 lines
3.2 KiB
Markdown
# writing-korean-technical-blogs
|
|
|
|
한국어 기술 블로그 한 편을 자료 기반으로 작성·재구성·검토하는 Agent Skill이다. 조사부터 게시까지 장기 상태를 관리하는 하네스가 아니라, **주어진 자료를 검증 가능한 기술 글로 변환하는 전문 작성 스킬**이다.
|
|
|
|
## 책임
|
|
|
|
- 글의 목적·독자·문서 유형 확인
|
|
- 사실·수치·코드·인용·공식 명칭 보존
|
|
- 주장과 근거 연결
|
|
- 문제·제약·선택·구현·결과·한계 중심 구조 설계
|
|
- 기술 선택의 대안과 비용 보존
|
|
- 불확실성·미측정·실패 조건 명시
|
|
- 기술 블로그에 맞는 제목·도입·결론 작성
|
|
|
|
## 책임 밖
|
|
|
|
- 여러 사이트를 조사해 근거를 수집하는 전체 리서치
|
|
- 명령어·코드의 실제 실행 검증
|
|
- 이미지·다이어그램·대표 이미지 제작
|
|
- CMS 게시와 배포 상태 관리
|
|
- AI 작성 여부 또는 탐지 확률 판정
|
|
|
|
이 작업들이 함께 필요하면 이 스킬을 하위 작업자로 호출하는 `technical-blog-production` 하네스를 별도로 둔다.
|
|
|
|
## 하위 스킬
|
|
|
|
권장 순서는 다음과 같다.
|
|
|
|
```text
|
|
원자료 정리
|
|
→ writing-korean-technical-blogs
|
|
→ reducing-ai-like-korean-writing
|
|
→ editing-korean-grammar-and-expression
|
|
→ 보호 항목 및 근거 최종 대조
|
|
```
|
|
|
|
하위 스킬이 설치되지 않은 환경에서는 이 스킬이 구조와 근거 검토까지만 수행하고, 문체·문법 검수 미실행을 경고해야 한다.
|
|
|
|
## 설치
|
|
|
|
Agent Skills 디렉터리에 폴더 전체를 복사한다. 폴더명과 frontmatter의 `name`은 반드시 `writing-korean-technical-blogs`로 일치해야 한다.
|
|
|
|
```text
|
|
skills/
|
|
└── writing-korean-technical-blogs/
|
|
├── SKILL.md
|
|
├── references/
|
|
├── profiles/
|
|
├── lexicons/
|
|
├── examples/
|
|
├── tests/
|
|
├── schemas/
|
|
└── scripts/
|
|
```
|
|
|
|
## 사용 예
|
|
|
|
```text
|
|
첨부한 실험 기록만 근거로 성능 개선 기술 블로그를 작성하세요.
|
|
대상 독자는 백엔드 개발자입니다.
|
|
수치가 없는 부분은 만들지 말고 확인 필요로 남기세요.
|
|
```
|
|
|
|
```text
|
|
이 초안을 architecture-decision 프로필로 재구성하세요.
|
|
결정하지 않은 대안과 남은 위험을 삭제하지 마세요.
|
|
```
|
|
|
|
```text
|
|
글을 고치지 말고 audit 모드로 구조·근거·보호 구간 문제만 진단하세요.
|
|
```
|
|
|
|
## 기본값
|
|
|
|
- 독자: 한국어를 읽는 소프트웨어 엔지니어와 기술 의사결정자
|
|
- 문체: 기존 문체가 일관되면 보존, 없으면 합니다체
|
|
- 수정 분량: 기존 초안 수정 시 원문 대비 약 ±15% 범위
|
|
- SEO: 요청이 없으면 키워드 반복이나 검색 최적화를 강제하지 않음
|
|
- 기업 문체: 별도 가이드가 없으면 정확·명료·절제된 기술 문체
|
|
- 공개 범위: 비밀, 키, 내부 주소, 개인정보, 미공개 장애 정보는 차단 또는 마스킹 경고
|
|
|
|
## 검증
|
|
|
|
```bash
|
|
python3 scripts/validate_skill.py
|
|
```
|
|
|
|
검증기는 구조, frontmatter, 규칙 ID, 테스트 커버리지, 보호 문자열, JSON Schema와 프로필 파일을 확인한다. 독립 에이전트의 실제 준수 여부는 `tests/pressure-scenarios.md`로 별도 A/B 테스트해야 한다.
|