Community코딩 & 개발github.com

jakirhussainkhan/dev-skills

AI를 사용하여 새로운 기술을 학습하고, 익숙하지 않은 코드베이스를 탐색하며, 면접을 준비하고, 기술 격차를 식별하거나 개인 학습 시스템을 구축할 때 사용하는 스킬입니다. 누군가를 돕기 위해 작업을 대신 수행하기보다는 학습하도록 도울 때도 사용합니다. 학습, 이해, 설명, 가르쳐 줘, 튜토리얼 등의 키워드에서 트리거됩니다.

dev-skills란 무엇인가요?

이 스킬은 AI 기반 학습의 핵심 철학인 '이해 부채(Comprehension Debt)'를 방지하고, AI를 학습의 대체재가 아닌 가속 도구로 활용하도록 돕습니다. 소크라테스식 문답법을 통해 스스로 사고하도록 유도하며, 새로운 기술 학습, 낯선 코드베이스 분석, 기술 격차 파악, 기술 면접 및 시스템 디자인 면접 준비, 개인 학습 시스템 구축 등 다양한 시나리오를 위한 구조화된 프롬프트를 제공합니다. 특히 'AI 학습 루프'와 '이해 사슬 워크플로우'와 같은 방법론을 통해 단계적으로 깊이 있는 이해를 추구하며, 학습 깊이와 AI 위임 사이의 균형을 찾는 데 중점을 둡니다. Claude Code, Cursor 등 다양한 AI 에이전트와 함께 사용할 수 있으며, 단순히 코드를 복사/붙여넣기 하는 반패턴을 피하고 항상 이해하려는 태도를 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/jakirhussainkhan/dev-skills/tree/HEAD/.github/skills/ai-assisted-learning

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

AI 기반 학습

핵심 철학

AI는 개발자 역량의 바닥을 끌어올리지만, 시니어 전문성의 천장은 문법이 아닌 판단력에 의해 결정됩니다.

AI 기반 학습의 가장 큰 위험은 '이해 부채(Comprehension Debt)'입니다. 즉, 이해하지 못하는 코드를 배포하는 것입니다. 목표는 AI를 자신의 생각을 대체하는 것이 아닌, 자신의 생각을 증폭시키는 힘의 배율기로 사용하는 것입니다.

핵심 규칙: AI를 사용하여 더 빨리 이해하는 데 사용하고, 이해를 건너뛰는 데 사용하지 마십시오.


소크라테스식 방법 (심층 학습에 가장 좋음)

정답을 요청하는 대신 대화를 요청하세요:

설정

[주제]에 대해 대화를 통해 배우고 싶습니다. 직접 해결책을 제시하지 마세요.
대신:
- 제 생각을 유도하는 질문을 해주세요
- 제가 놓친 부분을 알려주되, 채워주지는 마세요
- 제 가정에 이의를 제기해주세요
- 제 추론이 맞을 때만 확인해주세요

현재 제 이해 수준: [아는 것]
제 질문: [이해하고 싶은 것]

효과적인 이유

자신의 생각을 말로 표현하도록 강제하여 → 숨겨진 격차를 드러내고 → 단순히 답을 복사하는 대신 지속 가능한 정신 모델을 구축하게 합니다.

소크라테스 학습 단계

단계수행할 작업AI의 역할
1. 토론"왜 이렇게 동작하나요?"라고 질문질문하고, 가정에 도전
2. 결정논의를 명세로 변환아키텍처가 타당한지 확인
3. 정박구현 전에 테스트 작성실패 조건 정의
4. 구현단계별로 구축안내하고, 수행하지는 않음
5. 검증작업 검토격차를 찾고 개선 제안

새로운 기술 학습

AI 학습 루프

1. 개요: "[기술]에 대한 5분 개요를 제공해주세요.
               어떤 문제를 해결하나요? 대안과 비교하여 언제 사용해야 하나요?"

2. 정신 모델: "코드를 작성하기 전에 이해해야 할 핵심 개념을 설명해주세요."

3. 안내된 구축: "[작은 실용 예제]를 구축하는 과정을 안내해주세요.
                  각 결정 사항을 설명해주세요."

4. 도전: "방금 배운 내용을 시험해보세요.
                  엣지 케이스와 함정에 대해 질문해주세요."

5. 적용: 새로운 기술로 실제 무언가를 구축하세요.

6. 검토: "제 구현을 검토해주세요. 시니어 [X] 개발자라면
            무엇을 바꾸고 왜 그렇게 할까요?"

최신 상태 유지 (시니어 개발자 워크플로우)

  • AI를 사용하여 릴리스 노트를 스캔하고 실제로 중요한 내용을 요약
  • "[프레임워크] v[X]에서 내 기존 패턴에 영향을 미치는 변경 사항은 무엇인가요?"라고 질문
  • 병렬 실험 실행: "이전 방식과 새 방식으로 모두 구현하고 차이점을 설명해주세요"
  • Perplexity나 Gemini를 사용하여 "커뮤니티에서 현재 X에 대해 뭐라고 말하고 있나요?"를 확인

익숙하지 않은 코드베이스 탐색

AI를 사용한 온보딩

저는 이 코드베이스가 처음입니다. 체계적으로 이해할 수 있도록 도와주세요:
1. 이 프로젝트는 무엇을 하나요? (높은 수준)
2. 진입점/메인 흐름은 무엇인가요?
3. 주요 모듈과 각각의 책임은 무엇인가요?
4. 코드베이스 전체에서 일관되게 사용되는 패턴은 무엇인가요?
5. 새로운 개발자에게 혼란스러울 만한 것은 무엇인가요?

[README 또는 주요 파일 붙여넣기]

이해 사슬 워크플로우

1단계: "[기능]이 높은 수준에서 어떻게 작동하는지 설명해주세요"
2단계: "어떤 파일이 관련되어 있나요? 각각의 책임은 무엇인가요?"
3단계: "[특정 동작]에 대한 데이터 흐름을 설명해주세요"
4단계: "[특정 부분]을 수정하려면 무엇을 이해해야 하나요?"

특정 함수 이해하기

이 함수가 무엇을 하는지 설명해주세요. 다음을 포함하여:
- 입력으로 받는 것
- 반환하는 것
- 가진 부수 효과
- (추론할 수 있다면) 호출되는 위치
- 알아야 할 명확하지 않은 동작

[함수 붙여넣기]

기술 격차 분석

격차 식별

저는 주로 [스택]으로 작업하는 [수준] 개발자입니다.
[목표 역할/기술]로 성장하고 싶습니다.

이 맥락에서 제가 가질 가능성이 가장 높은 중요한 기술 격차는 무엇인가요?
(1) 현재 작업에 미치는 영향, (2) 경력 성장 가치 순으로 우선순위를 정해주세요.

특정 격차 해소

[특정 영역]에 약점이 있음을 깨달았습니다.
2주 학습 계획을 설계해주세요:
- 현재 수준에서 시작: [설명]
- 목표 역량에서 종료: [설명]
- 읽기만 하는 것이 아닌 실습 포함
- 하루 30-45분 소요

면접 준비

기술 면접

[회사 유형]의 [역할] 직무에 대한 기술 면접관 역할을 해주세요.
[주제]에 대해 면접을 봐주세요.

규칙:
- 중간 난이도 질문으로 시작
- 잘 대답하면 난이도 상승
- 어려워하면 힌트를 주고 후속 질문
- 각 답변 후 구체적인 피드백 제공
- 3개 질문 후 성과와 격차 요약

시스템 디자인 면접

[수준]에 적합한 시스템 디자인 질문을 해주세요.
제가 답변할 때:
- 결정에 대해 질문: "X 대신 Y를 선택한 이유는 무엇인가요?"
- 확장성에 대해 질문: "트래픽이 10배일 때 어떻게 달라지나요?"
- 가정에 도전: "데이터베이스가 병목이 된다면 어떻게 하나요?"
- 격차 지적: "아직 [X]를 다루지 않았습니다"

행동 면접 (STAR 형식)

STAR 형식을 사용하여 행동 면접 답변을 준비하는 것을 도와주세요.
목표 역할: [역할]
제 배경: [간략 요약]

이 역할에 대한 일반적인 행동 질문 5개를 제공해주세요.
제가 답변할 때마다 STAR를 사용하여 더 잘 구조화할 수 있도록 도와주세요.

개인 학습 시스템 구축

주간 AI 학습 루프

1. 월요일: 주간 학습 목표 정의
2. 매일: 30분 AI 안내 학습 세션
3. 구축: 소규모 프로젝트에 개념 적용
4. 금요일: AI가 작업 검토, 격차 식별
5. 주말: 선택 사항: 간격 반복 검토

기억 유지 계층

핵심 학습 내용을 지속 가능한 지식으로 전환:

  1. 각 AI 학습 세션 후, "이것에서 꼭 기억해야 할 가장 중요한 3가지는 무엇인가요?"라고 질문
  2. 자신의 언어로 작성 (복사/붙여넣기 금지)
  3. 테스트 생성: "이것을 진정으로 이해했는지 어떻게 알 수 있을까?"
  4. 매주 재방문

개인 지식 베이스 프롬프트

[개념]에 대한 참조 카드를 만드는 것을 도와주세요.
형식:
- 한 문장 정의
- 사용해야 하는 경우
- 사용하지 말아야 하는 경우
- 주요 함정
- 간단한 예제
- 기억해야 할 하나의 "아하" 순간 통찰

피해야 할 반패턴

반패턴해로운 이유더 나은 접근 방식
AI 코드를 읽지 않고 복사/붙여넣기이해 부채, 나중에 디버그 불가항상 사용하기 전에 읽고 이해
시도하기 전에 해결책 요청고군분투에서 발생하는 학습을 건너뜀먼저 시도한 후 피드백 요청
첫 번째 답을 진실로 받아들임AI는 자신 있게 틀릴 수 있음문서와 대조하고 직접 테스트
AI를 검색 엔진으로만 사용교육 기회를 놓침"어떻게"뿐만 아니라 "왜"를 설명하도록 요청
직접 구축하는 단계 건너뛰기새로운 맥락으로 지식 전이 불가항상 작은 규모라도 직접 구축

균형 테스트

스스로에게 물어보세요: "내일 AI가 사라진다면, 나는 이것을 여전히 할 수 있을까?" 아니오 → 해결해야 할 학습 격차가 있는 것입니다. 예 → AI를 힘의 배율기로 올바르게 사용하고 있는 것입니다.


깊이 배워야 할 경우와 AI에 위임할 경우

깊이 배워야 할 경우AI에 위임할 경우
핵심 언어 기초상용구 코드 생성
아키텍처 및 디자인 패턴반복적인 변환
디버깅 정신 모델문서 형식 지정
제품의 도메인 로직거의 사용하지 않는 구문
보안 원칙파일 스캐폴딩
시스템 디자인 트레이드오프테스트 상용구

경험 법칙: 그것을 이해하는 것이 향후 5년간 더 나은 엔지니어가 되는 데 도움이 된다면 깊이 배우십시오. 단순한 우발적 복잡성이라면 위임하십시오.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

jakirhussainkhan/dev-skills

Use this skill when building AI agents, designing multi-agent systems, integrating LLMs into applications, building RAG pipelines, working with vector databases, implementing MCP servers, or designing agent communication and orchestration patterns. Trigger on keywords like: agent, LLM, RAG, embeddings, vector DB, orchestration, tool use, memory, intent clarification, MCP, LangChain, LangGraph, CrewAI, AutoGen, Microsoft Agent Framework.

jakirhussainkhan/dev-skills

Use this skill when designing how an AI agent should communicate with developers — intent clarification, progress reporting, ambiguity handling, confirmation before irreversible actions, error communication, self-correction, task tracking, and plan mode. Also use when building agent UX or defining agent behavior rules. Trigger on keywords: agent communication, intent clarification, plan mode, agent behavior, task tracking, confirmation, agent UX, agentic workflow, agent protocol.

jakirhussainkhan/dev-skills

Use this skill when designing or reviewing APIs — REST, GraphQL, tRPC, or gRPC. Trigger on keywords: API design, REST, GraphQL, tRPC, gRPC, endpoint, schema, route, OpenAPI, Swagger, API versioning, pagination, API contract, HTTP methods.

jakirhussainkhan/dev-skills

Use this skill for backend development — server logic, authentication, microservices, serverless functions, middleware, background jobs, caching strategies, and backend architecture patterns. Trigger on keywords: backend, server, API endpoint, middleware, authentication, authorization, microservice, serverless, background job, queue, caching, session.

관련 스킬