document-haness/.agents/skills/writing-korean-technical-blogs

writing-korean-technical-blogs

한국어 기술 블로그 한 편을 자료 기반으로 작성·재구성·검토하는 Agent Skill이다. 조사부터 게시까지 장기 상태를 관리하는 하네스가 아니라, 주어진 자료를 검증 가능한 기술 글로 변환하는 전문 작성 스킬이다.

책임

• 글의 목적·독자·문서 유형 확인
• 사실·수치·코드·인용·공식 명칭 보존
• 주장과 근거 연결
• 문제·제약·선택·구현·결과·한계 중심 구조 설계
• 기술 선택의 대안과 비용 보존
• 불확실성·미측정·실패 조건 명시
• 기술 블로그에 맞는 제목·도입·결론 작성

책임 밖

• 여러 사이트를 조사해 근거를 수집하는 전체 리서치
• 명령어·코드의 실제 실행 검증
• 이미지·다이어그램·대표 이미지 제작
• CMS 게시와 배포 상태 관리
• AI 작성 여부 또는 탐지 확률 판정

이 작업들이 함께 필요하면 이 스킬을 하위 작업자로 호출하는 technical-blog-production 하네스를 별도로 둔다.

하위 스킬

권장 순서는 다음과 같다.

원자료 정리
→ writing-korean-technical-blogs
→ reducing-ai-like-korean-writing
→ editing-korean-grammar-and-expression
→ 보호 항목 및 근거 최종 대조

하위 스킬이 설치되지 않은 환경에서는 이 스킬이 구조와 근거 검토까지만 수행하고, 문체·문법 검수 미실행을 경고해야 한다.

설치

Agent Skills 디렉터리에 폴더 전체를 복사한다. 폴더명과 frontmatter의 name은 반드시 writing-korean-technical-blogs로 일치해야 한다.

skills/
└── writing-korean-technical-blogs/
    ├── SKILL.md
    ├── references/
    ├── profiles/
    ├── lexicons/
    ├── examples/
    ├── tests/
    ├── schemas/
    └── scripts/

사용 예

첨부한 실험 기록만 근거로 성능 개선 기술 블로그를 작성하세요.
대상 독자는 백엔드 개발자입니다.
수치가 없는 부분은 만들지 말고 확인 필요로 남기세요.

이 초안을 architecture-decision 프로필로 재구성하세요.
결정하지 않은 대안과 남은 위험을 삭제하지 마세요.

글을 고치지 말고 audit 모드로 구조·근거·보호 구간 문제만 진단하세요.

기본값

• 독자: 한국어를 읽는 소프트웨어 엔지니어와 기술 의사결정자
• 문체: 기존 문체가 일관되면 보존, 없으면 합니다체
• 수정 분량: 기존 초안 수정 시 원문 대비 약 ±15% 범위
• SEO: 요청이 없으면 키워드 반복이나 검색 최적화를 강제하지 않음
• 기업 문체: 별도 가이드가 없으면 정확·명료·절제된 기술 문체
• 공개 범위: 비밀, 키, 내부 주소, 개인정보, 미공개 장애 정보는 차단 또는 마스킹 경고

검증

python3 scripts/validate_skill.py

검증기는 구조, frontmatter, 규칙 ID, 테스트 커버리지, 보호 문자열, JSON Schema와 프로필 파일을 확인한다. 독립 에이전트의 실제 준수 여부는 tests/pressure-scenarios.md로 별도 A/B 테스트해야 한다.