status

설치 경로와 호스트 연결

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는 이 플러그인의 공용 런타임을 사용하므로 스킬 폴더만 따로 복사하지 않는다.

사용자에게는 한국어로 답하라. 사용자가 다른 언어로 말을 걸었다면 그 언어를 따른다.

이 프로젝트가 STATIC 과 어떤 관계인지, 설정이 어떻게 되어 있는지 한 번에 보여준다. 아무것도 바꾸지 않는다.

커맨드가 여럿이 되면서 설정이 흩어졌다 — 룰셋·범위·metric·자동 리포트가 각자 조회 커맨드를 갖고 있고 훅 스위치는 또 별개다. 이 커맨드는 그것들을 모아 볼 뿐 새로 하는 일이 없다.

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

서버를 네 번 조회하므로 잠깐 걸린다. 로컬만 빠르게 보려면 --local 을 붙인다.

읽는 법

project — linked: false 면 여기서 끝이다. 이 프로젝트는 STATIC 에 연결되지 않았고, 나머지 항목은 아예 없다. 그것이 답이니 "실패" 로 전하지 마라.

analysis

• bootstrapStatus 가 ready 가 아니면 부트스트랩이 안 끝난 것이다. 분석이 안 되는 이유가 대개 여기 있다.
• hookEnabled 와 hookEnabledGlobally 를 둘 다 보여줘라. 프로젝트만 껐는지 전역으로 껐는지 구분되지 않으면 "왜 자동 분석이 안 도나" 를 답할 수 없다.

server.analysis — 마지막 전체 분석이다. lastRevisionSequence 는 웹 History 에 보이는 번호(#8 등)이고, lastAnalyzedAt 은 그 시각(초 단위 epoch)이다. 둘 다 null 이면 성공한 분석이 아직 없다. 이 값은 경로를 가리지 않는다 — 웹에서 돌렸든 커맨드로 돌렸든 revision 이 생겼으면 잡힌다.

scope — 제외 건수. 0 이 아니면 분석에서 빠진 것이 있다는 뜻이므로, 결함 수를 함께 이야기할 때 반드시 언급하라.

server — 조각마다 error 가 따로 붙는다. 하나가 실패해도 나머지는 유효하다. 전부 실패했다면 서버가 내려갔거나 AccessKey 문제다.

어떻게 보여줄까

표 하나로 압축해라. 항목이 열 개가 넘으므로 문장으로 늘어놓으면 읽히지 않는다.

이상한 값을 먼저 짚어라. 사용자가 이 커맨드를 부르는 이유는 대개 뭔가 예상과 다르기 때문이다:

• 훅이 꺼져 있다
• bootstrapStatus 가 ready 가 아니다
• 제외 건수가 예상보다 많다
• 룰셋이 1개거나 전부(30/30)다 — 전부 켜면 룰 버전 충돌로 분석이 실패할 수 있다
• 서버 조각에 error 가 있다

이런 게 없으면 표만 보여주고 끝내라. 굳이 조언을 덧붙이지 마라.

결과 해석

• linked: false → 연결되지 않았다. 부트스트랩을 원하면 statica-analyze-bootstrap 스킬로 안내하되, 먼저 제안하지는 마라.
• server.error: "NO_SERVER_SETTING" → Arachne 설정에 서버가 없다. 설치 문제다.
• 조각별 error: "NO_ACCESS_KEY" (401) → AccessKey 문제다. 키를 사용자에게 묻거나 파일에 쓰지 마라.
• 조각별 error: "NOT_FOUND" (404) → 서버에 프로젝트가 없거나 서버가 구버전이다. 여러 조각이 함께 404 면 후자일 가능성이 높다.