understandcommit 08d16bdSKILL.md · 아키텍처 개선

코드 지식 그래프

코드베이스를 분석해 파일·관계·계층·투어를 담은 knowledge-graph.json을 .ua/에 만들어 대시보드로 볼 수 있게 합니다.

처음 실행 시 플러그인 디렉터리에서 pnpm install과 빌드를 수행하며, 큰 코드베이스는 많은 서브 에이전트를 써서 오래 걸립니다.

npx skills add Egonex-AI/Understand-Anything --skill understand

권한: read-repo
write-files
shell
network
호환 도구: Claude Code, Codex, Cursor, Copilot, Gemini CLI
GitHub: 89.5k
출처: 커뮤니티 · Egonex-AI
상태: 스캔 통과
라이선스: MIT
카테고리: 아키텍처 개선
저장소: github.com/Egonex-AI/Understand-Anything/understand-anything-plugin/skills/understand

핵심 규칙

오류를 조용히 버리지 않고, 모든 실패를 최종 보고서에 드러냅니다.

실행 단계

01단계사전 점검
프로젝트 루트와 .ua/ 데이터 디렉터리를 정하고, 필요하면 플러그인을 빌드하며, 기존 그래프로 전체 또는 증분 분석을 결정합니다.
02단계스캔과 배치
.understandignore와 --exclude 규칙에 따라 파일을 스캔하고 언어·프레임워크를 파악한 뒤 의미 단위 배치를 만듭니다.
03단계파일 분석
최대 5개의 서브 에이전트가 배치를 병렬로 분석하고, 노드와 엣지로 합친 뒤 조립된 그래프를 검토합니다.
04단계계층과 투어
아키텍처 계층을 식별하고 가이드 투어를 만든 뒤 전체 그래프를 검증합니다.
05단계저장과 보고
그래프, 지문 기준선, meta.json을 저장하고 중간 파일을 정리해 통계를 보고하며, 검증을 통과하면 대시보드를 엽니다.

권한 설명 (SKILL.md 기준)

기능	필요 여부	설명
파일 쓰기	일부 필요	프로젝트의 .ua/(또는 기존 .understand-anything/) 안에만 그래프, 설정, 중간 파일을 쓰며 소스는 바꾸지 않습니다.
명령 실행	필요	git, 동봉된 Node·Python 스크립트를 실행하고, 처음 사용할 때 pnpm install과 빌드를 수행합니다.
네트워크 송신	일부 필요	플러그인이 빌드되지 않았을 때 pnpm install로 의존성을 받는 경우뿐이며, 분석 자체는 네트워크를 쓰지 않습니다.

SKILL.md 프런트매터(YAML)commit 08d16bd

---
name: understand
description: Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
argument-hint: ["[path] [--full|--auto-update|--no-auto-update|--review|--language <lang>|--exclude <patterns>]"]
---

핵심 규칙

실행 단계

01단계사전 점검

02단계스캔과 배치

03단계파일 분석

04단계계층과 투어

05단계저장과 보고

권한 설명 (SKILL.md 기준)

SKILL.md 프런트매터(YAML)

관련 스킬