スキル codebase-mapping
🗺️

codebase-mapping

低リスク 📁 ファイルシステムへのアクセス

코드베이스 구조 및 종속성 매핑

익숙하지 않은 코드베이스를 이해하는 것은 시간이 많이 걸리고 오류가 발생하기 쉽습니다. 이 스킬은 저장소 구조, 종속성 그래프 및 진입점에 대한 포괄적인 맵을 생성하여 분석 속도를 높입니다.

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「codebase-mapping」を使用しています。 Map the structure of my FastAPI project

期待される結果:

  • Repository: my-fastapi-app
  • Structure Summary:
  • - 23 Python modules across 4 packages
  • - Primary entry: app/main.py
  • - Core packages: routers, models, services, utils
  •  
  • Key Files for Analysis:
  • - Types: models/user.py, models/product.py
  • - Execution: services/database.py
  • - Config: app/config.py
  •  
  • External Dependencies: fastapi, sqlalchemy, pydantic, uvicorn

「codebase-mapping」を使用しています。 Analyze the frontend directory for React components

期待される結果:

  • Frontend Structure:
  • - 45 TypeScript components
  • - Entry: src/index.tsx
  • - Component hierarchy: App → Pages → Features → UI
  •  
  • Key Dependencies:
  • - react, react-dom, react-router
  • - UI library: component-library
  • - State: zustand, react-query

セキュリティ監査

低リスク
v5 • 1/17/2026

Static scanner generated false positives due to pattern matching without semantic understanding. The skill only reads files within a specified directory to analyze code structure, excludes build/cache directories, and outputs JSON results. No network calls, code execution, or credential access detected. A prior audit (2026-01-10) correctly assessed this as low risk.

3
スキャンされたファイル
660
解析された行数
2
検出結果
5
総監査数
低リスクの問題 (1)
Broad filesystem access within target directory
The script recursively reads files in the target repository for analysis. Necessary for codebase mapping. Excludes node_modules, .git, __pycache__, and other build directories.

リスク要因

📁 ファイルシステムへのアクセス (1)
監査者: claude 監査履歴を表示 →

品質スコア

45
アーキテクチャ
100
保守性
85
コンテンツ
22
コミュニティ
88
セキュリティ
91
仕様準拠

作れるもの

레거시 시스템 아키텍처 분석

레거시 코드베이스를 매핑하여 모듈 경계를 이해하고 현대화 계획 수립

새로운 코드베이스 빠르게 탐색

주요 파일과 종속성을 식별하여 익숙하지 않은 저장소에 빠르게 적응

코드 아키텍처 문서화

팀 참조를 위한 코드베이스 구성에 대한 구조화된 문서 생성

これらのプロンプトを試す

기본 구조 맵
Map the structure of /path/to/repo and show me the main entry points and key dependencies
종속성 분석
Analyze the dependency graph for src/ directory and identify circular dependencies
진입점 발견
Identify all executable entry points in this codebase and their purposes
아키텍처 개요
Generate a comprehensive map of this codebase focusing on types, execution engines, and tool interfaces

ベストプラクティス

  • 소스 코드에 집중하기 위해 빌드 디렉토리와 종속성을 분석에서 제외
  • 생성된 주요 파일 목록을 사용하여 먼저 검토할 모듈의 우선순위 지정
  • 더 깊은 아키텍처 인사이트를 위해 다른 분석 스킬과 결합

回避

  • node_modules 또는 vendor 디렉토리를 분석하면 노이즈가 발생하고 분석이 느려짐
  • 출력 형식을 먼저 이해하지 않고 프로덕션 코드베이스에서 실행
  • 모든 진입점이 자동으로 감지된다고 가정 - 수동 검증 필요

よくある質問

이 스킬은 어떤 파일 유형을 분석하나요?
현재 Python(.py) 및 JavaScript/TypeScript(.js, .ts, .jsx, .tsx) 파일을 지원합니다
대규모 저장소는 어떻게 처리하나요?
스킬은 성능을 위해 디렉토리 순회 깊이를 제한하고 일반적인 빌드/캐시 디렉토리를 제외합니다
CI/CD 파이프라인과 통합할 수 있나요?
예, 스크립트는 파싱하여 자동화된 워크플로우에서 사용할 수 있는 JSON을 출력합니다
내 코드는 안전한가요? 외부로 데이터를 전송하나요?
모든 분석은 로컬에서 이루어집니다. 코드나 메타데이터가 시스템 외부로 전송되지 않습니다
일부 종속성을 놓치면 어떻게 하나요?
동적 import 및 런타임 전용 종속성은 감지되지 않을 수 있습니다. 정적 분석 결과를 시작점으로 사용하세요
표준 tree 명령과 어떻게 다른가요?
파일 구조 외에도 import를 분석하고 진입점을 식별하며 종속성 그래프를 구축합니다

開発者の詳細

ファイル構成