Community코딩 & 개발github.com

hearthbook-tools/spreadsheet-agent-skills

라이브 수식, 입력 탭, 검증 기능을 갖춘 Excel/Google Sheets 워크북을 제작 및 감사합니다. 하드코딩된 숫자, 깨진 참조, 짧은 SUM 범위를 린트합니다. 모든 스프레드시트 제작 또는 감사에 사용하세요.

spreadsheet-agent-skills란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor 등)가 비즈니스 스프레드시트를 올바르게 제작하고 감사할 수 있도록 설계되었습니다. `script/lint_workbook.py` 스크립트를 실행하여 엑셀(.xlsx) 파일을 분석하고, 깨진 참조(#REF!, #DIV/0!, #N/A), SUM 범위 누락, 하드코딩된 숫자 등 주요 오류를 보고합니다. 워크북 제작 시에는 `reference/build_rules.md`에 따라 입력 탭(가정 값), 계산 탭(라이브 수식), 검증 탭(자동 점검)을 포함하며, 엑셀 2016+ 및 구글 시트와 호환되는 함수만 사용하도록 강제합니다. 사용자는 이 스킬을 통해 스프레드시트 오류를 사전에 방지하고, 데이터 변경에도 안정적으로 작동하는 워크북을 얻을 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hearthbook-tools/spreadsheet-agent-skills/tree/HEAD/skills/formula-first-workbook

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

수식 우선 워크북

번들 스크립트를 항상 먼저 실행하세요. 이 스크립트는 수동 계산 결과와 대조하여 테스트되었습니다. 워크북을 처음부터 다시 만들지 마십시오. 사용자가 요청하는 경우에만 추가 탭, 차트 또는 서식을 나중에 추가할 수 있으며, 스크립트의 탭과 수식은 변경하지 않은 상태로 유지해야 합니다.

비즈니스용 스프레드시트는 숫자가 변경되어도 계속 작동해야 합니다. 이 스킬을 사용하면 Claude가 라이브 수식을 사용(붙여넣은 결과값 사용 금지)하여 워크북을 제작하고, 합계를 조용히 망가뜨리는 실수를 찾기 위해 모든 .xlsx를 감사합니다.

워크북 제작 시

reference/build_rules.md를 따르세요. 간단히:

  1. 입력 탭: 모든 가정 값(요율, 가격, 날짜, 백분율)마다 레이블, 단위, 출처 메모와 함께 배치합니다. 수식은 이 셀들을 참조하며, 수식 내에 0, 1, 12, 100을 제외한 숫자를 입력하지 않습니다.
  2. 계산: 열 전체에 동일한 수식을 사용합니다. 합계는 전체 열 범위(향후 입력을 위한 빈 버퍼 행 포함)를 포함합니다.
  3. 검증 탭: 각 합계당 최소 하나의 검증(예: "카테고리 합계 = 총합", "음수 잔액 없음")을 수행하여 OK 또는 메시지를 표시합니다.
  4. 색상 코드: 입력은 연한 노란색, 수식은 회색입니다. 헤더 행을 고정합니다.
  5. Excel 2016+ 및 Google Sheets에서 작동하는 함수만 사용하세요(SUMIFS, COUNTIFS, INDEX/MATCH, IFERROR, ROUND, EOMONTH). 사용자가 Microsoft 365를 확인하지 않는 한 LET, LAMBDA, XLOOKUP, 동적 배열은 피하세요.
  6. 저장 후 린터(아래 참조)를 실행하고 전달 전에 모든 ERROR를 수정하세요.

워크북 감사

python scripts/lint_workbook.py FILE.xlsx [--json]

시트 및 셀별로 다음을 보고합니다:

  • ERROR: 깨진 참조(#REF!, 누락된 시트 참조), 캐시된 오류 값(#DIV/0!, #N/A, …), 합계 바로 위의 숫자를 포함하지 않는 SUM/합계 범위.
  • WARN: 수식 열 내에 입력된 숫자(덮어쓰여진 수식), 이웃 수식과 패턴이 다른 수식, 수식 내 매직 넘버.

발견된 사항을 사용자에게 평이한 언어로, 가장 심각한 것부터 시작하여 셀 주소와 수정 방법을 요약하세요. 파일이 스크립트에 의해 생성되었고 엑셀에서 열린 적이 없는 경우 캐시된 값이 없습니다. 수식이 평가되었다고 말하는 대신 그렇게 말하세요.

관련 스킬