Files
document-haness/.agents/skills/writing-korean-technical-blogs/references/decision-policy.md
T
DongHyeonkaandClaude Opus 5 25644cc4d9 feat: install korean technical blog skill bundle
.agents/skills의 technical-document-author,
revising-korean-technical-prose, writing-natural-korean을
korean-technical-blog-skills-bundle-v1의 세 스킬로 교체한다.

- writing-korean-technical-blogs: 문제·제약·선택·구현·결과·한계 구조화
- reducing-ai-like-korean-writing: 상투성·추상화·반복 제거
- editing-korean-grammar-and-expression: 맞춤법·띄어쓰기·호응 검수

상류를 수정하지 않고 복사했다. diff -r 0건, MANIFEST.sha256 검증 통과,
번들 validate_skill.py 3/3 PASS.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-07 14:20:42 +09:00

1.8 KiB

판단 우선순위와 불변식

우선순위

  1. 사실·법무·보안·코드·직접 인용
  2. 사용자 요구와 프로젝트·기업의 공식 가이드
  3. 공식 제품명과 프로젝트 용어
  4. 한국어 어문 규범
  5. 기술 독자의 이해와 접근성
  6. 기술 블로그 장르 구조
  7. AI 유사 문체 완화
  8. 미적 변주와 개성 강화

하위 규칙이 상위 규칙을 침해하면 하위 수정을 취소한다.

불변식

  • 긍정·부정, 조건, 예외, 시제, 시간 순서
  • 가능성·권고·의무·확정의 강도
  • 주체, 객체, 책임 범위와 1인칭 관점
  • 수치, 단위, 날짜, 버전, 오류 코드와 지표 정의
  • 기술 선택의 이유, 비교한 대안, 비용과 위험
  • 실험 환경, 표본, 미측정 상태와 불확실성
  • 제품명, 기술명, API·클래스·함수·설정 키
  • 코드, 명령어, URL, 직접 인용, 법무·보안 문구
  • 마크다운의 코드 블록, 표, 목록과 링크 구조

즉시 실패

  • 원문에 없는 수치·성과·사례·감정·사용자 반응 생성
  • 코드·명령어·법무 문구·직접 인용 변경
  • 민감 정보 또는 미공개 정보를 그대로 공개
  • 불리한 결과, 실패 조건, 비용 또는 위험 삭제
  • 미측정 결과를 검증된 결과처럼 작성
  • 작성 주체가 불명확한데 임의로 개인이나 팀에 책임 부여

정보 부족

  • 글의 목적·독자·문서 유형이 없어도 안전한 기본값으로 진행할 수 있으면 가정 목록에 기록한다.
  • 사실 여부나 구조를 바꾸는 필수 정보가 없으면 한 번에 필요한 최소 질문만 하거나 [확인 필요]로 남긴다.
  • 선택적인 배경·회고·성과 정보가 없으면 해당 섹션을 생략한다.
  • 자료끼리 충돌하면 더 높은 우선순위의 출처를 사용하고 충돌을 경고한다.