scopelisted
Install: claude install-skill SuresoftTechnologies/statica-plugin
## 설치 경로와 호스트 연결
PLUGIN_ROOT는 이 진입점이 속한 설치 플러그인 루트다. skills/<id>/SKILL.md에서는 ../..이다. 공용 scripts/assets/tmpa는 플러그인 루트에 한 번만 배치한다. 스킬의 references와 보조 문서는 해당 스킬 파일 기준이다.
`${PLUGIN_ROOT}`와 `${PLUGIN_DATA}`가 셸에 자동 설정됐다고 가정하지 않는다. 로드한 파일의 실제 위치로 루트를 확인하고, 실행할 때 실제 절대경로로 대체하거나 동일 셸 호출에서 변수를 설정한다. PLUGIN_DATA는 호스트가 제공하는 영속 데이터 경로를 우선 사용하고, 없으면 사용자 데이터 디렉터리 아래 이 플러그인 전용 경로를 사용한다. 사용자의 분석 대상 작업 디렉터리는 바꾸지 않는다. bash 예제는 bash에서 실행한다.
SKILL_ROOT는 지금 읽은 SKILL.md의 부모 디렉터리다. 이 스킬 전용 scripts/assets는 SKILL_ROOT 아래에 있다. `${SKILL_ROOT}`는 설명용 표기이며 자동 설정된 환경변수가 아니다. 스크립트 실행 시 로드한 SKILL.md의 실제 위치로 절대경로를 구성���다. 프로젝트 작업 디렉터리를 스킬 폴더로 바꾸지 않는다.
## 실행 경로
`${SKILL_ROOT}`는 이 SKILL.md가 있는 디렉터리의 절대 경로로 바꿔 실행한다. 작업 디렉터리는 분석 대상 프로젝트에 유지한다. `scripts/run.py`는 이 플러그인의 공용 런타임을 사용하므로 스킬 폴더만 따로 복사하지 않는다.
**사용자에게는 한국어로 답하라.** 사용자가 다른 언어로 말을 걸었다면 그 언어를 따른다.
이 프로젝트의 **분석 범위**를 보여주고 바꾼다. 생성 코드·서드파티·테스트 픽스처처럼 결함을 봐도 고칠 생각이 없는 것들을 빼는 데 쓴다. 지금까지 Arachne UI 에서만 할 수 있던 일이다.
설정은 워크스페이스의 `analysis.scope.json` 에 남고 **Arachne UI 와 같은 파일을 공유한다.** 여기서 바꾸면 UI 에도 그대로 보인다.
## 1. 지금 상태부터 읽는다. 예외 없다.
```bash
python "${SKILL_ROOT}/scripts/run.py" scope-show --project-dir "$(pwd)"
```
- `excluded` 는 지금 빠져 있는 것, `included` 는 **빠진 폴더 안에서 되살려 둔 예외**다.
- `scopeFile` 은 실제로 읽고 쓰는 파일이다. 위치가 언어마다 달라서(`C/C++` 은 `.staticdata/config/` 아래, 나머지는 워크스페이스 루트) 뭔가 이상할 때 제일 먼저 볼 값이다.
- `modules` 는 C/C++ 빌드 모듈 목록이다 (다른 언어에서는 빈 목록). `output` 이 모듈의 식별자이자 `--path` 에 넣을 값이고, `skipped` 가 지금 빠져 있는지다. `capturedSources` 와 `analyzedTus` 가 어긋나면 아직 분석되지 않