Skip to content

chore(skills): /eli5 — 쉽게 풀되 정확도를 안 깎는 설명 스킬 추가 - #691

Closed
Khyojae wants to merge 1 commit into
mainfrom
chore/eli5-skill
Closed

Khyojae wants to merge 1 commit into
mainfrom
chore/eli5-skill

Conversation

@Khyojae

@Khyojae Khyojae commented Sep 8, 2026

Copy link
Copy Markdown
Member

Summary

어려운 개념·문서·코드 경로를 쉬운 한국어로 푸는 Claude Code 스킬. 실패 모드를 **"어렵다"가 아니라 "쉬워졌는데 틀렸다"**로 잡고, 그걸 막는 규칙을 넣었다.

출력이 5블록으로 고정된다 — 한 줄 / 왜 필요한가 / 비유 하나 / 🔴 비유가 깨지는 곳 / 진짜 용어 대응표.

  • 4번이 이 스킬의 존재 이유다. 비유를 믿고 한 걸음 더 밀면 틀리는 지점을 반드시 적게 했다
  • 5번은 면접용이다. 쉬운 말과 정식 용어를 짝지어 손에 쥐어준다

이 저장소에 맞춘 제약

  • 원문의 «미검증·추정·상관/인과·조건» 표시를 반드시 살린다. 이 저장소 문서는 거의 전부 단서가 붙어 있고, 쉽게 푼다는 명목으로 그걸 떼면 추정을 사실로 세탁하는 것이다
  • 숫자를 뭉개지 않는다 — "훨씬 빠르다"가 아니라 "4.11배"
  • 메커니즘이 문서에 없으면 지어내지 말고 "아직 안 갈렸다"로 둔다. 그럴듯한 인과를 발명하는 것이 ELI5의 가장 흔한 사고다
  • docs/decisions/는 «결정»이 아니라 **«분기점»**이라, "문서에 이렇게 적혀 있다"를 "이렇게 하기로 했다"로 풀면 틀린다
  • 실측값은 무대 조건(로컬 2코어 vs EC2)을 같이 옮긴다
  • "학생이니까 이 정도만" 류 면죄부 금지 — 쉽게 설명하는 것과 기준을 낮추는 것은 다른 일이다

Test plan

  • 실제 호출로 시험 — /eli5 반동기 복제를 면접에서 어떻게 말하지
    • 스킬 지시대로 원문 3개(replication-lag-and-semisync.md · 08-22 AWS 라운드 · 08-17 로컬 라운드)를 먼저 읽고 나서 답했다
    • 5블록 전부 나왔고, 원문의 조건 넷(같은 AZ · SQL writer · 계측 바닥 ~1초 · main이 아닌 커밋)과 미검증 표시가 살아남았다
    • 숫자도 안 뭉개졌다 (−5.9% · p95 +13.0% · 단일 핫세션 −10.3% · timeout 10,658ms)

참고

.claude/skills/verify/와 같은 프로젝트 스코프다. 마지막 절이 이 저장소 전용이라, 전역(~/.claude/skills/)으로 옮길 거면 그 절은 떼는 게 맞다.

Co-Authored-By: Claude Opus 5 (1M context) noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01GijKcMJ4Qzez1XDEJEMBZZ

🤖 Generated with Claude Code

https://claude.ai/code/session_01GijKcMJ4Qzez1XDEJEMBZZ

어려운 개념·문서·코드 경로를 쉬운 한국어로 푸는 스킬. 실패 모드를 "어렵다"가
아니라 "쉬워졌는데 틀렸다"로 잡고 그걸 막는 규칙을 넣었다.

출력이 5블록으로 고정된다 — 한 줄 / 왜 필요한가 / 비유 하나 / 🔴 비유가 깨지는 곳 /
진짜 용어 대응표.

- 4번(비유가 깨지는 곳)이 이 스킬의 존재 이유다. 비유를 믿고 한 걸음 더 밀면
  틀리는 지점을 반드시 적게 했다
- 5번은 면접용이다. 쉬운 말과 정식 용어를 짝지어 손에 쥐어준다
  ([[user_career_target]] — 백엔드 신입 + DBA 병행)

이 저장소에 맞춘 제약:

- 원문의 «미검증·추정·상관/인과·조건» 표시를 반드시 살린다. 이 저장소 문서는 거의
  전부 단서가 붙어 있고, 쉽게 푼다는 명목으로 그걸 떼면 추정을 사실로 세탁하는 것이다
- 숫자를 뭉개지 않는다 — "훨씬 빠르다"가 아니라 "4.11배"
- 메커니즘이 문서에 없으면 지어내지 말고 "아직 안 갈렸다"로 둔다. 그럴듯한 인과를
  발명하는 것이 ELI5의 가장 흔한 사고다
- docs/decisions/ 는 «결정»이 아니라 «분기점»이라, "문서에 이렇게 적혀 있다"를
  "이렇게 하기로 했다"로 풀면 틀린다
- 실측값은 무대 조건(로컬 2코어 vs EC2)을 같이 옮긴다
- "학생이니까 이 정도만" 류 면죄부 금지 — 쉽게 설명하는 것과 기준을 낮추는 것은 다른 일이다

`.claude/skills/verify/` 와 같은 프로젝트 스코프다. 마지막 절이 이 저장소 전용이라
전역(~/.claude/skills/)으로 옮기려면 그 절은 떼는 게 맞다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GijKcMJ4Qzez1XDEJEMBZZ
@coderabbitai

coderabbitai Bot commented Sep 8, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 59 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 5b4594b9-effb-41e8-8520-6c08c292a854

📥 Commits

Reviewing files that changed from the base of the PR and between f560dd4 and 5501d66.

📒 Files selected for processing (1)
  • .claude/skills/eli5/SKILL.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Khyojae

Khyojae commented Sep 8, 2026

Copy link
Copy Markdown
Member Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Sep 8, 2026

Copy link
Copy Markdown
⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@Khyojae

Khyojae commented Sep 15, 2026

Copy link
Copy Markdown
Member Author

#736 에 같은 파일(.claude/skills/eli5/SKILL.md, 내용 동일)이 포함돼 머지됐다 — 이 PR 은 diff 가 비어 닫는다.

@Khyojae Khyojae closed this Sep 15, 2026
@Khyojae
Khyojae deleted the chore/eli5-skill branch September 15, 2026 06:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant