---
name: metric
description: 어떤 코드 메트릭을 측정할지 켜고 끈다
user-invocable: true
disable-model-invocation: true
---

## 설치 경로와 호스트 연결

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


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

이 프로젝트가 측정할 **코드 메트릭**을 켜고 끈다. 순환복잡도·중첩깊이·LOC 같은 것들이다. 지금까지 Arachne UI 의 Project Settings 에서만 할 수 있던 일이다.

**이 커맨드가 다루는 것은 사용 여부뿐이다.** 경고 임계값(Diagnosis 단계)은 건드리지 않는다. 사용자가 "복잡도 10 넘으면 경고" 같은 것을 원하면 웹 UI 로 안내하라.

## 1. 지금 상태부터 읽는다

```bash
python "${SKILL_ROOT}/scripts/run.py" metric-show --project-dir "$(pwd)"
```

`bySection` 에 섹션별로 묶여 있다. **섹션 구성은 언어가 정한다** — C/C++ 은 `FUNCTION` · `FILE` · `CLASS` · `MODULE` 네 개이고, java·kotlin·python·csharp 은 `CLASS` 가 없다. 우리가 정하는 것이 아니라 서버가 내려주는 `sections` 를 그대로 따라라.

**표로 보여줘라.** 34개까지 나오므로 문장으로 나열하면 읽을 수 없다. 섹션마다 이렇게:

| | key | 이름 |
|---|---|---|
| ✓ | FUNST | Number of Statements |
| | FUCYC | Cyclomatic Complexity |

`key` 를 반드시 함께 보여라 — 다음 단계에서 그것으로 지정한다.

목록이 길면 **켜진 것을 먼저, 꺼진 것은 접어서** 보여주고 "전체를 보시겠습니까"로 물어도 좋다. 다만 사용자가 특정 섹션을 말했다면 그 섹션은 전부 펼쳐라.

## 2. 무엇을 켜고 끌지 확정받는다

**전체 교체가 아니다.** 말한 것만 바뀌고 나머지는 그대로다. 그래서 룰셋처럼 "최종 목록 전체"를 확인시킬 필요는 없고, **바뀌는 것만** 보여주면 된다.

사용자가 이름으로 말하면(`복잡도` 처럼) 목록에서 찾아 **어느 key 인지 확인시킨 뒤** 진행하라. 이름이 여러 개에 걸리면 물어라.

## 3. 적용한다

```bash
python "${SKILL_ROOT}/scripts/run.py" metric-set --project-dir "$(pwd)" \
  --on FUCYC --on FUMNC --off FUNGS
```

- `--on` · `--off` 는 반복한다. 한 번의 호출로 **한 트랜잭션**에서 처리된다.
- 같은 key 를 양쪽에 주면 `--off` 가 이긴다.

## 결과 해석

- `ok: true` → `message` 를 전하고, **다음 분석부터** 반영된다는 점을 알려라. 이미 올라간 revision 의 메트릭 값은 바뀌지 않는다.
- `code: "UNKNOWN_METRIC"` (404) → key 가 틀렸다. **아무것도 바뀌지 않았다** — 서버가 한 트랜잭션으로 처리하므로 부분 적용은 없다. 1번을 다시 읽어 정확한 key 를 확인하라.
- `code: "NO_CHANGES"` → `--on` · `--off` 를 하나도 주지 않았다.
- `code: "FORBIDDEN"` (403) → **metric 설정 변경은 프로젝트 소유자만 할 수 있다.** 조회는 됐는데 변경만 막혔다면 이 경우다.
- `code: "NO_ACCESS_KEY"` (401) → Arachne 설정의 AccessKey 문제다. **키를 사용자에게 묻거나 파일에 쓰지 마라.**
- `code: "NOT_FOUND"` (404) → 서버에 그 프로젝트가 없거나, 서버가 Open API v1 을 포함하지 않은 구버전이다.
- `code: "NEEDS_BOOTSTRAP"` → 이 프로젝트가 아직 STATIC 에 연결되지 않았다 (`statica-analyze-bootstrap` 스킬).

**메트릭을 끄면 그 지표가 사라진다.** 값이 좋아지는 것이 아니라 측정하지 않게 되는 것이다. 끄자고 제안할 때는 그 사실을 분명히 하고, 이후 분석 결과를 보고할 때도 지표가 줄어든 이유가 설정 변경임을 함께 말하라.