코드베이스 변경을 구현하기 전에 관련 파일, 의존성 및 테스트 파일을 구조화된 지도로 생성합니다.
- GitHub 스타
- 41,038
- 파일
- 1
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
- 허용된 도구
- —
context-map skill은 무엇을 하나요?
context-map은(는) agent skill입니다. 코드베이스 변경을 구현하기 전에 관련 파일, 의존성 및 테스트 파일을 구조화된 지도로 생성합니다.
skill의 SKILL.md에서 생성된 요약입니다.
context-map skill 정보
이 SKILL은 코드베이스를 수정하기 전에 관련 파일, 의존성 및 테스트 스위트를 매핑할 수 있도록 지원합니다. 개발자는 실제 코드를 작성하기 전에 분석 단계를 거치도록 강제함으로써 의도하지 않은 부작용을 방지하는 데 이 기능을 사용합니다. 에이전트가 기존 리포지토리의 변경이 필요한 작업 설명을 받으면 이 도구를 로드해야 하며, 이 도구는 즉각적인 코드 수정 대신 구조화된 마크다운 보고서를 생성합니다.
프로세스는 작업과 관련된 파일을 코드베이스에서 검색하고, 직접적인 import 및 export를 식별하며, 기존 테스트를 찾는 과정을 포함합니다. 또한 일관성을 보장하기 위해 현재 코드에서 유사한 패턴을 스캔합니다. 결과물인 컨텍스트 맵에는 수정할 파일, 업데이트가 필요할 수 있는 의존성, 영향을 받는 테스트 파일 목록이 테이블 형태로 포함됩니다. 마지막으로 public API 변경, 데이터베이스 마이그레이션 및 구성 요구 사항을 다루는 위험 평가로 마무리됩니다.
agent가 수행할 수 있는 작업
- 1구현 전 코드베이스 분석코드를 작성하기 전에 특정 기능 요청과 관련된 모든 파일 및 의존성 맵을 생성하도록 에이전트에게 요청합니다.
- 2회귀 위험 식별새로운 기능을 커버하기 위해 어떤 테스트 파일을 업데이트해야 하는지 확인하는 데 이 도구를 사용합니다.
- 3아키텍처 일관성 유지새로운 변경 사항이 기존 스타일을 따르도록 기존 코드 패턴을 검색하도록 요청합니다.
- 4배포 영향 평가제안된 변경 사항이 데이터베이스 마이그레이션이나 구성 업데이트를 필요로 하는지 평가합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
context-map skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 context-map skill 설치
~/.claude/skills/context-map/SKILL.md
$ npx degit github/awesome-copilot/skills/context-map ~/.claude/skills/context-mapClaude Code (project)에 context-map skill 설치
.claude/skills/context-map/SKILL.md
$ npx degit github/awesome-copilot/skills/context-map .claude/skills/context-mapCodex에 context-map skill 설치
~/.agents/skills/context-map/SKILL.md
$ npx degit github/awesome-copilot/skills/context-map ~/.agents/skills/context-mapGemini CLI에 context-map skill 설치
~/.gemini/skills/context-map/SKILL.md
$ npx degit github/awesome-copilot/skills/context-map ~/.gemini/skills/context-mapClaude.ai에 context-map skill 설치
npx degit github/awesome-copilot/skills/context-map context-map && zip -r context-map.zip context-map # claude.ai → Customize → Skills → + → Create skill → Upload a skill → context-map.zip
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능github/awesome-copilot/skills/context-map is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/context-m ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-11github.com/github/awesome-copilot/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/context-m ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/context-m ↗통과
- SKILL.md가 Agent Skills 형식을 따름the description does not say when to use the skillgithub.com/github/awesome-copilot/blob/HEAD/skills/context-m ↗결함 발견
SKILL.md
GitHub에서 보기Context Map
Before implementing any changes, analyze the codebase and create a context map.
Task
{{task_description}}
Instructions
- Search the codebase for files related to this task
- Identify direct dependencies (imports/exports)
- Find related tests
- Look for similar patterns in existing code
Output Format
## Context Map
### Files to Modify
| File | Purpose | Changes Needed |
|------|---------|----------------|
| path/to/file | description | what changes |
### Dependencies (may need updates)
| File | Relationship |
|------|--------------|
| path/to/dep | imports X from modified file |
### Test Files
| Test | Coverage |
|------|----------|
| path/to/test | tests affected functionality |
### Reference Patterns
| File | Pattern |
|------|---------|
| path/to/similar | example to follow |
### Risk Assessment
- [ ] Breaking changes to public API
- [ ] Database migrations needed
- [ ] Configuration changes required
Do not proceed with implementation until this map is reviewed.
이 스킬의 파일
1context-map skill 질문
Claude Code에 context-map skill을 어떻게 설치하나요?
npx degit github/awesome-copilot/skills/context-map ~/.claude/skills/context-map를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
context-map skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
컨텍스트 맵은 언제 생성해야 하나요?
코드베이스에 변경 사항을 구현하기 전에 맵을 생성해야 합니다.
맵을 생성한 직후에 에이전트가 바로 코딩을 시작할 수 있나요?
아니요, 에이전트는 구현을 진행하기 전에 생성된 맵에 대한 검토를 기다려야 합니다.