report-generator

설치 경로와 호스트 연결

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. 지금 설정부터 읽는다

python "${SKILL_ROOT}/scripts/run.py" report-generator-show --project-dir "$(pwd)"

• enabled: false → 꺼져 있다. "한 번도 정한 적이 없다"와 구분되지 않는다 — 서버가 두 경우를 같은 값으로 돌려주므로 구분되는 척하지 마라.
• enabled: true → format 과 kindNames 로 무엇이 만들어지는지 함께 보여라.

2. 무엇을 만들지 확정받는다

끄기만 할 거면 아무것도 묻지 마라. 바로 3번으로 간다.

켜거나 바꾼다면 두 가지를 받아야 한다.

형식 — DOC · PDF · HTML · EXCEL

종류 — 하나 이상. 번호가 아니라 이름으로 물어라.

전체 교체다. 1번에서 읽은 것에 더하는 게 아니라, 여기서 정한 것이 전부가 된다. 최종 목록을 보여주고 승인을 받아라.

3. 적용한다

python "${SKILL_ROOT}/scripts/run.py" report-generator-set on --project-dir "$(pwd)" \
  --format EXCEL --kind 1 --kind 2

python "${SKILL_ROOT}/scripts/run.py" report-generator-set off --project-dir "$(pwd)"

• off 에는 --format · --kind 가 필요 없다.
• on 인데 --kind 가 없으면 거부된다(EMPTY_KINDS). 서버는 그 조합을 저장은 하지만 분석 후 아무것도 만들지 않는다 — 켜 둔 줄 알고 영영 기다리게 되므로 여기서 막는다.

결과 해석

• ok: true → message 를 전하고, 다음 분석부터 적용된다는 점을 알려라. 이미 끝난 분석은 소급되지 않는다.
• code: "EMPTY_KINDS" → 위 참조.
• code: "BAD_FORMAT" · "BAD_KIND" → message 에 고를 수 있는 값이 들어 있다. 그대로 보여주고 다시 물어라.
• code: "FORBIDDEN" (403) → 이 설정 변경은 프로젝트 매니저 권한이다. 조회는 됐는데 변경만 막혔다면 이 경우다. 매니저에게 요청하도록 안내하라.
• code: "NO_ACCESS_KEY" (401) → Arachne 설정의 AccessKey 문제다. 키를 사용자에게 묻거나 파일에 쓰지 마라.
• code: "NOT_FOUND" (404) → 서버에 그 프로젝트가 없거나, 서버가 Open API v1 을 포함하지 않은 구버전이다.
• code: "NEEDS_BOOTSTRAP" → 이 프로젝트가 아직 STATIC 에 연결되지 않았다 (statica-analyze-bootstrap 스킬).

자동 생성을 켜 두면 분석마다 보고서가 쌓인다. 서버 저장 용량을 쓰는 일이니, 매 분석이 아니라 가끔 필요한 것이라면 /statica:report 로 그때그때 만드는 편이 낫다는 점을 한 번은 알려 줘라.