haslanli/glance

glance은(는) 무엇을 하나요?

누군가가 답변을 받았지만, 그것을 이해할 시간이나 배경 지식이 부족할 때 사용합니다. 한눈에(glance) 보면 그 답변이 무엇을 의미하는지, 무엇을 해야 하는지, 아직 알려지지 않은 것이 무엇인지 알 수 있어야 합니다. tldr은 이미 그 언어를 아는 독자를 위해 답변을 압축하고, glance는 답변을 '번역'하여 보여줍니다.

명령어

인수가 help(또는 --help, -h, ?)이면, 이 블록을 정확히 출력하고 중단합니다:

/glance            마지막 답변을 한눈에 재구성
/glance <대상>     하나의 답변, 일부, 또는 여러 답변 재구성: "빌드에 대한 답변",
                   "숫자만", "오늘 한 모든 것", "지금까지의 모든 결정",
                   또는 붙여넣은 텍스트
/glance on         마지막 답변을 재구성한 후, /glance off 명령어까지 이 방식으로 답변
/glance super      on과 같지만, 모든 불릿을 단편으로 줄임
/glance off        일반 답변으로 복귀
/glance status     현재 모드가 무엇인지 표시
/glance help       이 내용 표시

- 모든 숫자, 이름, 경로, 단계, 경고 및 미해결 질문은 유지됩니다.
- 답변에 데이터가 있으면 차트, 타일, 그리드, 카드 또는 재구성된 표로 시각화됩니다.
- 모드는 이 대화에서만 /glance off 명령어까지 지속됩니다.
- /btw 내에서는 모드가 이월되지 않습니다. 터미널에서는 /btw가 한 번만 답변하고 아무것도 유지하지 않습니다. 데스크톱 앱에서는 /btw가 사이드 채팅을 열므로, 거기서 설정된 모드는 해당 사이드 채팅에만 유지됩니다.

어떤 답변을 대상으로 하는가

• 인수 없음, on 또는 super: 이 명령어 직전 Claude가 제공한 마지막 답변입니다. 요청하지 않으면 전체 스레드가 아니며, 사용자의 메시지나 원시 도구 출력도 아닙니다. 해당 답변이 이미 glance였다면, 그 이전 답변을 대상으로 합니다. 대상이 없으면 한 줄로 말하고 중단합니다.
• 다른 모든 인수는 지시사항입니다. 동료가 이해하는 방식으로 읽습니다. 답변을 가리키거나("마이그레이션에 대한 답변", "두 메시지 위"), 범위를 좁히거나("숫자만", "결정만"; 내부는 모두 유지, 외부는 모두 삭제), 여러 답변 또는 세션 전체를 포괄하거나("오늘 한 모든 것", "지금까지의 모든 결정", "итог всего прогресса"), 붙여넣은 텍스트를 포함하거나, 이들을 결합할 수 있습니다. 두 개의 답변이 조건에 맞으면 가장 최근 것을 선택하고 한 줄로 이름을 표시합니다. 조건에 맞는 답변이 없으면 한 줄로 말하고 중단합니다. 절대 다른 것으로 대체하지 않습니다.
• 사용자의 자신의 말로 요청한 경우(/glance 없이 "покажи кратко", "too long, just the gist", "where are we with all of this?"): 요청을 지시사항으로 읽고, 어떤 언어로든 그 언어로 답변합니다.
• 오직 답변만이 출처입니다. 선택된 답변의 내용만 재구성합니다. 파일, 도구 출력 또는 대화에서 이전에 본 데이터는 포함하지 않습니다. 답변이 세 가지 서비스를 하나의 행으로 병합했다면, glance는 그 하나의 행을 유지합니다.
• 이미 짧고 명확한 경우(전문가가 아닌 사람도 이해할 수 있는 몇 줄): 변경 없이 반환하고, 이미 한눈에 볼 수 있다는 한 줄을 추가합니다.
• 모드 중인 경우: 해당 턴의 작업(도구, 확인, 편집)을 정상적으로 수행한 후, 답변을 glance 형식으로 제공합니다.

여러 답변 또는 세션 전체

지시사항이 여러 답변(지금까지의 진행 상황, 세션 요약, 특정 시점 이후의 모든 것, 모든 결정)을 포괄하는 경우, 이 모든 것을 하나의 glance로 재구성합니다:

• 출처: 해당 범위 내에서 Claude가 제공한 모든 답변, 사용자가 그 과정에서 밝힌 결정, 그리고 Claude가 유지한 작업 목록(있는 경우). 이전 glance는 이미 범위 내의 답변을 재구성한 것이므로 건너뜁니다. 오직 대화 내용만으로 구성합니다. git 히스토리, 파일 또는 트래커를 읽어 빈칸을 채우지 않습니다. 독자는 여기서 발견되고 수행된 것이 무엇인지 묻고 있기 때문입니다. 범위의 일부가 더 이상 대화에 없는 경우(예: 이전 턴이 요약으로 압축된 경우), 있는 내용을 사용하고 한 줄로 무엇을 다루는지 말합니다.
• 답변당 하나가 아닌, 하나의 glance입니다. 첫 번째 문장은 전체적인 상황을 나타냅니다. 불릿은 독자의 질문(무엇이 완료되었는지, 무엇이 결정되었는지, 아직 열려 있는 것은 무엇인지, 다음 단계는 무엇인지)을 중심으로 이 내용의 자체 표현으로 그룹화합니다. 사실이 속한 단계는 이해에 필요한 경우에만 표시합니다.
• 병합하고, 모든 것을 유지합니다. 여러 답변에서 반복되는 사실은 한 번만 나타납니다. 모든 답변의 모든 숫자, 이름, 경로, 명령어, 경고 및 미해결 질문이 유지됩니다.
• 나중 답변이 우선합니다. 나중 답변이 이전 답변을 업데이트하거나 모순되는 경우(새로운 측정값, 적용된 수정, 번복된 결정), 나중 버전을 사용하고 그 옆에 몇 단어로 설명합니다: "/search 280ms (주조 수정 전 350ms)". 나중 답변에서 해결된 미해결 질문은 더 이상 미해결이 아닙니다.
• 시각 자료는 여전히 최대 세 개의 섹션으로 구성됩니다. 범위 전체에서 가장 중요한 데이터에 할당하며, 일반적으로 데이터가 있는 단계당 하나의 섹션입니다. 나머지는 간결한 표나 불릿으로 들어갑니다.
• 길이는 모든 출처 답변을 합친 것을 기준으로 측정됩니다.

glance의 형태

다음 순서로 구성됩니다:

1. 일상적인 단어로 된 답변. 한두 개의 짧은 문장, 최대 약 25단어로, 친구에게 말하는 방식으로 작성합니다: "10월 초 두 가지 변경으로 인해 청구서가 두 배 이상 증가했습니다." 원본의 표현을 그대로 사용하지 않고, 전문 용어나 풀어내기 어려운 은유를 피합니다.
2. 데이터가 있는 경우 시각 자료. 아래 참조.
3. 시각 자료가 보여주지 않는 내용에 대한 불릿: 원인, 단계, 결정, 주의 사항, 미해결 질문.
   • 독자의 질문(왜 발생했는지, 무엇을 해야 하는지, 아직 알려지지 않은 것은 무엇인지, 그들에게 필요한 것은 무엇인지)을 중심으로 그룹화하고, 각 그룹을 이 내용의 자체 표현으로 레이블을 지정합니다("10월 초 두 가지 변경", "수정 사항, 가장 저렴한 순서"). 원본의 제목을 재사용하지 않고 고정된 레이블 집합을 사용하지 않습니다.
   • 불릿당 한 줄, 최대 두 줄로, 문장보다는 짧은 구로 작성합니다(길이 참조).
   • 비전문가를 막을 수 있는 용어가 처음 나오고, 답변을 이해하는 데 필요한 경우 2~4단어의 설명을 대괄호 안에 추가합니다. 일상적인 단어는 설명하지 않으며, glance당 한두 개로 제한합니다.
   • 명령어, 코드, 경로 및 오류 텍스트는 코드 서식으로 그대로 유지합니다.

그 외에는 아무것도 없습니다. 문장은 시각 자료 앞에, 불릿은 바로 뒤에 위치하며, 둘 사이에 답변을 다시 설명하거나 시각 자료를 설명하는 단락이 없어야 합니다.

시각 자료

언제 사용하는가. 답변에 데이터가 있을 때마다 사용합니다: 비교할 숫자(항목, 그룹 또는 시간 간), 동일한 세부 정보를 가진 여러 항목, 변경된 값, 또는 여러 항목 각각의 상태. 이러한 경우 시각 자료는 기본값이지 추가 사항이 아닙니다. 답변이 대부분 추론이고 숫자가 몇 개만 있는 경우에는 시각 자료를 건너뜁니다.

무엇을 사용하는가. 이 데이터를 한눈에 읽을 수 있게 만드는 모든 것. 주제나 습관이 아니라 답변이 데이터에 대해 말하는 바에 따라 선택합니다. 두 개의 청구서가 두 개의 다른 시각 자료를 필요로 할 수 있습니다. 답변의 첫 번째 문장을 읽고 독자가 그것을 믿기 위해 무엇을 보아야 하는지 질문합니다.

• 합계가 A에서 B로 변경되었고, 답변이 그 차이를 구성하는 변경 사항을 제공하는 경우 → 단계가 정확히 합산되는 브리지 차트
• 한 항목이 변경의 거의 전부를 차지하는 경우 → 해당 항목을 타일로 먼저 제시(정확한 산술인 경우 해당 항목의 비율), 나머지는 막대 그래프로
• 각 행이 여러 기간의 값을 가지고 있고, 각 행의 변동이 중요한 경우 → 행당 작은 인라인 추세선이 포함된 표
• 항목이 한 값에서 다른 값으로 이동했고, 답변에서 제공하는 예산, 목표 또는 경쟁자와 비교되는 경우 → 각 값 아래에 벤치마크를 흐리게 표시한 이전 → 이후 행
• 문제, 실패, 손실 또는 낭비가 원인별로 그룹화된 경우 → 원인 목록: 각 원인에 대해 개수 또는 금액 막대와 그 아래 영향을 받은 항목
• 답변이 다루는 1~4개의 수치 → 헤드라인 타일(단일 숫자는 타일이며, 막대 하나만 있는 차트는 절대 사용하지 않음)
• 하나의 값이 한계 또는 전체와 비교되는 경우(디스크 92% 사용, 예산 80% 소진), 또는 여러 항목이 각각의 한계와 비교되는 경우 → 게이지
• 기간 또는 범주별 하나의 시리즈(최대 12개) → 세로 막대; 시간에 따른 더 많은 포인트 → 선 그래프
• 항목별 금액 → 가장 큰 것부터 하나의 축에 막대 그래프
• 하나의 합계가 2~6개 부분으로 나누어지고, 답변이 분할에 관한 경우 → 부분 목록 위에 분할 막대; 부분들을 서로 비교하려면 → 막대 그래프
• 일부 항목은 증가하고 다른 항목은 감소하는 변경 사항이 모두 하나의 단위로 표시되는 경우 → 0선에서 갈라지는 막대
• 이전 → 이후, 또는 여러 항목 각각에 대한 몇 개의 숫자(행마다 단위가 다를 수 있음) → 숫자당 하나의 정렬된 열이 있는 표, 보아야 할 행은 파란색으로 강조, 답변이 목표나 한계를 제시하는 경우 해당 선에 대한 막대 추가
• 각 설정에서 각 항목의 상태(테스트 매트릭스) → 설정당 하나의 열과 모든 셀에 하나의 단어가 있는 표, 실패한 셀만 빨간색으로 표시
• 동일한 세부 정보를 가진 옵션 → 권장 옵션이 표시된 비교표

파이 또는 도넛 차트, 두 번째 Y축, 하나의 차트에 두 개 이상의 선은 절대 사용하지 않습니다. 키트의 세 가지 색상(소프트 블루, 블루, 레드)만 사용합니다. 위의 형식으로 데이터를 하나의 척도와 하나의 단위로 정직하게 표시할 수 없는 경우 표를 사용합니다.

하나에서 세 개의 섹션으로 구성된 하나의 시각 자료(예: 타일, 메인 차트, 목록). 모든 값은 시각 자료에 표시되므로, 마우스 오버에 의존하지 않습니다. 키트는 두 가지 예외(많은 포인트가 있는 선, 인라인 추세)를 명명하고 호버 읽기 기능을 제공합니다.

가치가 있을 때만 대화형으로 사용합니다. 데이터에 한 번에 받아들이기 어려운 행이 너무 많은 경우(약 15개 이상) 또는 답변이 동일한 행을 두 가지 이상의 방식으로 분할하는 경우(제목별 및 언어별, 월별 및 서비스별)에만 시각 자료를 대화형으로 유지합니다. 그런 다음 키트의 대화형 표(정렬, 필터 칩, 긴 목록을 위한 검색 상자) 또는 보기 전환을 사용하고, 다음 규칙을 따릅니다:

• 아무도 클릭하기 전의 첫 번째 보기는 이미 질문에 답해야 합니다: 모든 행이 표시되고, 정적 시각 자료가 표시되는 방식으로 정렬 및 표시되거나, 답변이 다루는 슬라이스가 표시됩니다.
• 컨트롤은 원본의 데이터를 다른 방식으로만 보여줍니다. 가정, 예측, 추세선, 평균 또는 원본에 없는 숫자는 없으며, 값을 변경하거나 계산하는 컨트롤도 없습니다.
• 필터는 답변의 자체 범주와 단어를 사용합니다("손실만", "실패"), 답변이 만들지 않은 그룹화는 절대 사용하지 않습니다.
• 필터링된 보기는 표시되는 행 수를 표시합니다("40개 중 12개 표시").
• 컨트롤이 있는 하나의 표만 사용하며, 여러 차트를 대시보드로 연결하지 않습니다.
• 시각적 도구가 없으면 클릭할 것이 없습니다: 첫 번째 보기가 표시되는 방식으로 정렬된 전체 표를 제공합니다.

방법.

• 시각적 도구가 있는 경우(Claude 데스크톱 앱, /btw 사이드 채팅 포함, visualize 도구): read_me를 mockup 및 data_viz 모듈과 함께 호출합니다(선 그래프의 경우에만 chart 추가). 그런 다음 이 스킬의 폴더에 있는 references/ui-kit.md를 읽고 시각 자료를 구축합니다: 해당 CSS 블록을 정확히 붙여넣고, 한 문장의 스크린 리더 요약으로 시작하며, 해당 구성 요소만 사용하고 스타일을 재정의하지 않습니다. 도구의 가이드와 키트가 다른 경우 키트가 우선합니다. show_widget으로 그립니다. 답변 문장은 show_widget을 호출하기 전에 작성한 답변의 첫 번째 텍스트입니다(read_me를 먼저 호출하는 것은 괜찮습니다). 독자가 그림보다 먼저 답변을 얻도록 하기 위함입니다. 불릿은 그 후에 옵니다.
• 답변이 청구서나 지출 변경을 설명하는 경우, 먼저 references/bills.md를 읽습니다: 해당 독자가 무엇을 보아야 하는지와 위의 형식 중 어떤 것이 적합한지 설명합니다.
• 시각적 도구가 없는 경우(터미널, 또는 터미널의 /btw): 마크다운 표(아래와 같이 재구성) 또는 불릿 내부의 이전 → 이후 형식을 사용합니다.
• 색상은 의미를 전달하는 데만 사용됩니다: 소프트 블루는 일반 표시용, 블루는 주목해야 할 항목용, 레드는 부정적인 항목용입니다. 직접 레이블이나 짧은 범례로 설명합니다.
• 값과 레이블은 시각 자료에 표시합니다. 설명 문장은 답변에 남깁니다.

재구성하고, 정확히 맞춥니다. 재구성이 더 빨리 읽힐 때 원본의 표를 그대로 복사하지 마십시오: 중요한 것(일반적으로 가장 큰 변경 또는 가장 중요한 항목 먼저)으로 정렬하고, 중요한 행을 표시하거나 표를 차트로 변환합니다. 그러나 어떻게 재구성하든 정확해야 합니다:

• 원본과 동일한 행, 동일한 값, 동일한 단위. 삭제, 병합 또는 반올림하지 않습니다.
• 데이터에 있는 키(예: 달러 변경)로 정렬한 다음, 정렬 후 순서를 확인합니다.
• 원본이 지원하는 것만 표시합니다: "악화"는 원본이 그렇게 말하거나 숫자가 분명히 잘못된 방향으로 이동한 경우에만 표시합니다. "권장"은 권장하는 경우에만 표시합니다.
• 파생된 숫자(차이, 비율)는 시각 자료에만 추가하고, 원본 값의 정확한 산술이고 시각 자료에 필요한 경우(브리지 단계, 주요 항목의 비율)에만 추가합니다. 계산된 것으로 레이블을 지정합니다. 그렇지 않으면 숫자를 추가하지 않으며, 불릿에 새로운 개수나 비교를 절대 추가하지 않습니다.
• 원본의 값이 명확하지 않은 경우, 그대로 유지합니다.

정확하게 디자인합니다. 키트가 간격, 글꼴 크기, 정렬, 다크 모드 및 좁은 패널을 처리하므로 재정의하지 마십시오. 키트가 결정할 수 없는 사항:

• 시작할 위치. 답변이 다루는 그림, 항목 또는 행은 파란색으로 강조됩니다(hi, 또는 표 행의 경우 at). 다른 모든 것은 소프트 블루 및 보조로 유지됩니다.
• 동일한 순서, 동일한 이름. 항목은 타일, 차트, 행 및 불릿에서 동일한 순서와 동일한 이름으로 나타납니다.
• 동일한 단위, 숫자 우선. 하나의 행 또는 시리즈 내에서 모든 값을 동일한 방식으로 작성합니다("8 vCPU", "4 vCPU"), 원본과 동일한 단위, 구분 기호 및 소수점을 사용합니다. "전용"과 같은 수식어는 값 아래 작은 줄에 들어가며, 약 20자로 유지합니다. 더 긴 메모는 불릿에 속합니다.
• 결정적인 셀을 눈에 띄게 만듭니다. 옵션당 최대 하나의 플래그가 지정된 단점, 원본이 그 이유로 제시하는 것, 몇 단어로 설명합니다("Postgres와 타이트", "예산 초과"). 권장 옵션을 표시합니다. 독자가 이유를 보기 위해 모든 셀을 스캔할 필요가 없어야 합니다.
• 행당 한 줄. 원본이 사용하는 이름을 사용하고, 짧게 유지하여 모든 표 행이 한 줄로 유지되고 동일한 높이가 되도록 합니다. 이름을 설명해야 하는 경우 불릿에서 일반 단어로 설명합니다.
• 파란색은 여기를 보라고 말하고, 빨간색은 부정적이라고 말합니다. 파란색은 답변이 다루는 내용에 사용합니다. 나쁜 소식이라도 마찬가지입니다. 청구서를 급증시킨 서비스는 파란색입니다. 빨간색은 답변이 제시하는 한계(한도, 목표 또는 예산)를 넘거나 실패한 값에만 사용합니다: 해당 숫자, 해당 선을 넘는 막대의 부분, ...

...

[번역을 위해 잘렸습니다]