report-generatorlisted
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`는 이 플러그인의 공용 런타임을 사용하므로 스킬 폴더만 따로 복사하지 않는다.
**사용자에게는 한국어로 답하라.** 사용자가 다른 언어로 말을 걸었다면 그 언어를 따른다.
**분석이 성공하면 서버가 알아서 보고서를 만들어 두는** 기능을 켜고 끈다. 여기서 설정만 해두면 그 뒤로는 손댈 것이 없다.
**`/statica:report` 와 관계가 없다.** 그쪽은 "지금 하나 만들어서 받기"고, 이쪽은 "앞으로 매번 자동으로"다. 이 설정을 읽어서 `/statica:report` 를 부르는 식으로 엮지 마라 — 서버가 분석 후에 직접 만든다.
## 1. 지금 설정부터 읽는다
```bash
python "${SKILL_ROOT}/scripts/run.py" report-generator-show --project-dir "$(pwd)"
```
- `enabled: false` → 꺼져 있다. **"한 번도 정한 적이 없다"와 구분되지 않는다** — 서버가 두 경우를 같은 값으로 돌려주므로 구분되는 척하지 마라.
- `enabled: true` → `format` 과 `kindNames` 로 무엇이 만들어지는지 함께 보여라.
## 2. 무엇을 만들지 확정받는다
**끄기만 할 거면 아무것도 묻지 마라.** 바로 3번으로 간다.
켜거나 바꾼다면 두 가지를 받아야 한다.
**형식** — `DOC` · `PDF` · `HTML` · `EXCEL`
**종류** — 하나 이상. 번호가 아니라 이름으로 물어라.
| | | | |
|---|--