DongHyeonkaandClaude Opus 5
25644cc4d9
.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>
1.5 KiB
1.5 KiB
제목·도입·결론
제목
대상과 행동 또는 갈등을 드러낸다.
| 약한 제목 | 개선 방향 |
|---|---|
| Kubernetes 살펴보기 | Kubernetes로 배포 롤백을 자동화한 방법 |
| 성능 개선 이야기 | 검색 API p95를 420ms에서 180ms로 줄인 과정 |
| Kafka 도입기 | 장시간 작업에서 Kafka 대신 RDB Task Queue를 선택한 이유 |
수치 제목은 근거와 범위가 명확할 때만 사용한다.
도입
첫 15% 안에 다음 세 가지를 드러낸다.
- 어떤 시스템·작업에서 무슨 문제가 있었는가
- 왜 독자에게 중요한가 또는 어떤 제약이 있었는가
- 글을 읽으면 무엇을 알 수 있는가
시대 일반론, 의례적 인사, ‘여정을 살펴보겠다’는 메타 문장으로 시작하지 않는다.
소제목
소개, 배경, 내용, 결론만 쓰지 말고 절의 판단이나 동작을 표현한다.
배경→배포가 18분 걸린 이유구현→실패 단계를 분리해 로그를 남기기결과→평균 배포 시간은 줄었지만 승인 대기는 남았다
결론
다음 중 실제 자료가 있는 항목으로 끝낸다.
- 어떤 결정을 내렸는가
- 어떤 결과를 어떤 조건에서 확인했는가
- 무엇은 해결하지 못했는가
- 어디까지 적용 가능한가
- 다음에 무엇을 측정하거나 바꿀 것인가
본문을 다시 요약하거나 ‘더 나은 미래’, ‘많은 것을 배웠다’, ‘지속적으로 발전시키겠다’로 끝내지 않는다.