← ClaudeAtlas

statica-analyze-overviewlisted

STATIC 정적분석에 손대기 전에 먼저 읽어라. /statica:pre-analyze·/statica:upload 같은 이 플러그인의 커맨드를 쓰려 할 때, 응답이 끝난 뒤 [STATIC] 요약이나 부트스트랩 안내가 저절로 나타나 이유가 궁금할 때, STATIC이 보고한 결함을 근거로 코드를 고칠지 판단하려 할 때 사용한다. 이 플러그인의 범위와 금지선, 두 진입점, 전제 조건을 알려준다.
SuresoftTechnologies/statica-plugin · ★ 0 · Code & Development · score 75
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에서 실행한다. **사용자에게는 한국어로 답하라.** 사용자가 다른 언어로 말을 걸었다면 그 언어를 따른다. # statica 플러그인 개요 ## 무엇을 하는가, 그리고 어디서 멈추는가 작업 디렉터리의 프로젝트에 연결된 STATIC 워크스페이스의 분석 결과를 **항상 최신으로 유지**한다. 변경된 소스만 골라 다시 분석하고, 결함 건수와 룰별 요약을 보고하고, 요청이 있으면 서버에 반영한다. **결함을 읽고 코드를 고치는 일은 이 플러그인의 몫이 아니다.** 그 작업은 별도 플러그인에서 다룬다. 이것은 선택이 아니라 설계상의 경계다. - 이 플러그인의 출력(결함 건수, `topRules`, `.ci` 집계)을 근거로 **소스 파일을 편집하지 마라.** - **결함을 파일별로 나열하지 마라.** 보고하는 것은 분석의 상태이지 결함의 내용이 아니다. - 사용자가 결함 수정을 원하면, 그것은 이 플러그인 밖의 일임을 알리고 사용자의 지시를 받아라. ## C/C++ 분석 오류 복구 사용자가 툴체인 복구를 요청하거나 C/C++ 분석 오류를 발견하면 같은 플러그인의 `statica-toolchain-recovery` 스킬을 사용한다. 확보된 분석 오류 폴더로 설정 후보를 복사본에서 검증하고 Wrapper 설정을 반영하는 절차이며, 소스 결함 수정과는 다르다. 오류 폴더가 없으면 경로를 확인하고, 진단·설명만 요청받았으면 그 범위를 넘지 않는다. Stop 훅 자체가 복구 CLI를 자동 실행하는 것은 아니다. 복구 후 재빌드·전체 재분석은 별도 작업으로 인계한다. ## 두 갈래의 분석기 지원 언어는 다섯이고, 그 아래 분석기는 둘이다. **어느 갈래인지는 워크스페이스가 정한다** (`agent.json` 의 `language`, 없으면 C/C++). 결과 JSON 에 `language` 필드가 있으면 아래 오른쪽 칸이다. | | C/C++ | java · kotlin · python · csharp | | --- | --- | --- | | 분석기 | `analyzer-csa` | `analyzer-plugin` | | 연결 방법 | 빌드를 wrapper 로 가로채 캡처 | 기술서(빌드 플러그인이