매번 말로 설명하던 회계 검증 업무를 Skill로 만들고, 다른 컴퓨터의 에이전트에게 "가르치게" 했다
2026.07.22

이 글은 그냥 쓴 게 아니라, 지금 이 윈도우 머신에서 실제로 돌려본 결과입니다. 아래 스샷 2장 + 증거 원본은 전부 진짜입니다.
📝 한줄요약 (바쁘면 이것만)
분기마다 반복하던 회계 데이터 검증 업무를 에이전트용 업무 설명서(Skill)로 만들었더니, 내 맥의 에이전트가 회사 노트북의 에이전트에게 슬랙으로 그 업무를 직접 가르치는 단계까지 갔습니다. 그리고 방금, 그 "회사 노트북"을 이 윈도우 PC로 삼아 진짜 실행 + 진짜 bot-to-bot 시험까지 해봤습니다.
🎯 이런 분께 추천
에이전트한테 매번 같은 업무를 처음부터 다시 설명하고 있는 분
Skill이 "프롬프트 저장" 이상으로 뭐가 되는지 궁금한 분
컴퓨터 여러 대에서 에이전트를 굴리는데, 한쪽에서 배운 걸 다른 쪽에 옮기고 싶은 분
😫 문제 상황 (Before)
분기 결산마다 하는 일 중에 이런 게 있습니다: ERP에서 뽑은 분개장(모든 전표 기록)과 계정코드표를 가지고, 재무제표의 계정 매핑이 맞는지 금액으로 검증(대사)하는 일 정합성검증을 해야합니다. 감사 대응의 기초 작업인데, F/S Tie-out은 넘나 귀찮습니다... 매핑부터 귀찮아요.
에이전트에게 시켜보니 되긴 되는데, 이제는 하네스를 꽉잡고 검증까지 돌려서 범용성있는 스킬로 탄생시키고자 했습니다.
🛠️ 사용한 도구
Hermes (로컬 에이전트 프레임워크) — 맥과 윈도우 노트북 양쪽에서 운영
Skill 시스템 — 업무 절차를 마크다운 설명서 + 실행 스크립트로 패키징
Slack — 두 에이전트가 대화하는 공용 채널
📚 개념 정리: 에이전트 워크플로우의 5가지 부품
이번 주 과제를 하면서 각 부품의 역할이 명확해졌습니다. 제 업무에 대입하면:
부품 역할 제 업무에서는
개념 정리: 에이전트 워크플로우의 5가지 부품
부품 | 역할 | 제 업무에서는 |
|---|---|---|
Context | 지금 대화에 올라와 있는 정보 | "이번 분기 분개장 파일 여기 있어" |
Memory | 세션이 바뀌어도 남는 사실 | "이 사용자는 성급한 단정을 싫어함" 같은 취향 |
Tool | 에이전트의 손발 | 터미널, 파일 읽기/쓰기, Slack API |
Skill | 재사용 가능한 업무 설명서 | 이번에 만든 "분개장 대사 절차" |
Workflow | 위 부품들이 실제로 굴러가는 순서 | 파일 받기 → Skill 로드 → 실행 → 검증 → 보고 |
핵심 깨달음: 매번 Context로 넣어주던 설명이 반복되면, 그게 바로 Skill로 승격시켜야 할 신호라는 것.
🔧 만든 Skill: 분개장-계정 대사 자동검증
과제 요구사항대로 사용 조건부터 완료 기준까지 정리한 게 이 Skill의 뼈대입니다.
항목 | 내용 |
|---|---|
사용 조건(트리거) | "분개장 대사", "계정 매핑 검증", 분개장+계정코드표를 주며 재무제표와 맞춰보라고 할 때 |
필요한 입력 | ①분개장(기간 전체 전표) ②계정코드표(마스터) ③검증 대상(재무제표 양식) |
작업 순서 | 구조 실측 → 키 체계 확정 → 집계 → 매핑 해석 → 대사 → 이상 계정 역추적 (6단계) |
출력 형식 | 매핑 장표 + 계정별 대사 리포트(일치/불일치 판정) + 이상 계정 추적 자료 |
주의사항 | 한국 ERP의 .xls는 텍스트 위장이 흔함 / 계정 이름 중복 주의 / 부분 실패는 조용히 넘기지 말고 가시화 |
완료 기준 | 차변합=대변합(0원 일치) 통과 + 전 계정 금액 일치 + "골든 테스트"(이전 검증 결과와 완전 일치) 통과 |
설계하면서 가장 신경 쓴 건 완료 기준을 이진(통과/실패)으로 만든 것입니다. "대충 맞는 것 같다"가 없게, 모든 게이트가 0원 일치 아니면 실패입니다. 에이전트는 애매한 평가엔 약하지만 Y/N 판정엔 강하더군요.
또 하나, 회사 데이터와 절차를 분리했습니다. Skill 본문에는 일반화된 절차만 넣고, 회사 고유 값(계정 매핑, 파일 경로)은 로컬 설정 파일로 뺐습니다. 덕분에 Skill 자체는 어떤 회사 데이터로도 재사용 가능하고, 공유해도 안전합니다. 그리고 시중erp들 자료를 xls, xlsx, txt로 받을수 있다면 전부다 범용성있게 사용할 수 있습니다. 회사마다 COA 코드가 다르고 출력물 형태가 다르더라도 같은 매커니즘으로 맞춰서 스킬이 재구성 되는게 장점입니다.
🏃 첫 실행 로그: 잘 된 점과 막힌 점
잘 된 점
새 세션에서 "분개장 대사해줘" 한 마디로 6단계 절차가 그대로 돌았습니다. 설명 반복 제로.
완료 기준을 이진으로 박아둔 덕에, 에이전트가 "다 됐습니다"라고 말하려면 실제로 검증 게이트를 통과해야 합니다. 못 하면 어디서 막혔는지 보고하게 됩니다.
막힌 점 1: 윈도우 이식에서 터진 함정들
맥에서 만든 Skill을 회사 노트북(윈도우)의 에이전트에게 이식했더니 연달아 깨졌습니다. 깨진사유는 범용성 있게 여러 erp의 출력물이 되도록 하다보니 불안한 코딩때문이었습니다.
윈도우의
python명령이 망가져 있어서py런처로 바꿔야 했고한국어 윈도우 콘솔(cp949 인코딩)에서 이모지 출력이 크래시를 냈습니다 → 실행 스크립트 맨 위에
sys.stdout.reconfigure(encoding="utf-8")삽입으로 해결
해결하고 나서 중요한 걸 했습니다: 이 함정들을 Skill 본문 상단에 추가했습니다. 다음에 어떤 에이전트가 윈도우에서 이 Skill을 실행해도 같은 데서 안 넘어지도록. Skill은 만들고 끝이 아니라, 실행하다 막힌 걸 다시 흡수하면서 자라는 문서였습니다.
클라이맥스: 에이전트가 에이전트를 가르치고, 시험까지 봤다
설정이 뚫린 뒤, 메인 에이전트가 공용 채널에서 노트북 에이전트에게 Skill 위치·실행법·핵심 절차를 가르치고, 이해도 확인 시험을 냈습니다:
① 대사의 기준이 되는 키가 뭐고, 왜 화면에 보이는 계정코드만으로는 안 되지? ② 골든 테스트는 어떻게 돌리고, 뭐가 나와야 통과야?
노트북 에이전트는 자기 로컬에 설치된 Skill 문서를 직접 읽고 두 문제 다 정확히 답했습니다. 심지어 제가 묻지 않은 세부 구분(집계용 키와 대사용 키의 차이)까지 스스로 짚었습니다.
그리고 방금, 진짜로 해봤습니다. 이 윈도우 PC를 "회사 노트북"으로 삼아:
실제 Skill 엔진을 이 머신에서 구동 → BS 대사 117/117 일치(0원), PL 62코드 전액 일치
골든 테스트 → 재실행 산출물이 사전 백업과 값 단위로 전량 완전 일치 통과
별도 서브에이전트(이 대화 기억 0)를 띄워 로컬
SKILL.md를 직접 열게 하고 위 2문제를 냄 → 정답 + 집계용/대사용 키 구분까지 정확히 답변
아래는 그 실제 증거입니다.
📸 스샷 1 — bot-to-bot 티칭 대화 (Slack 스타일)
📸 스샷 2 — 이 윈도우 머신에서의 실제 실행 + 골든 테스트
windows execution proof
증거 원본(실제 로그/트랜스크립트)은
evidence/에 그대로 남겨뒀습니다:
01_pipeline_run.log— 실제 파이프라인 실행 로그
02_slack_relay.png— bot-to-bot 티칭 화면
03_notebook_agent_transcript.log— 노트북 에이전트(서브에이전트) 실제 트랜스크립트
04_notebook_agent_answer.txt— 노트북 에이전트의 실제 시험 답안
05_windows_execution_proof.png— 윈도우 실행·골든테스트 증거

✅ 결과 (Before / After)
Before | After | |
|---|---|---|
업무 설명 | 세션마다 처음부터 반복 | "분개장 대사해줘" 한 마디 |
검증 신뢰도 | "다 된 것 같은데요" | 이진 게이트 전 항목 통과해야 완료 |
다른 컴퓨터 이식 | 사람이 처음부터 다시 셋업 | Skill 복사 + 에이전트 간 슬랙 티칭 |
함정 지식 | 내 머릿속 | Skill 문서에 축적, 모든 에이전트가 공유 |
💬 배운 팁
효과적이었던 것
완료 기준을 이진으로: "차변합=대변합 0원"처럼 Y/N으로 판정 가능한 기준만 넣기. 에이전트의 "되겠지" 보고가 사라집니다. Mapping Validation / Verification을 위한 논리 적정성을 검증을 2개의 봇의 서로 대화로 실현합니다.
절차와 데이터 분리: Skill엔 일반 절차만, 회사 고유값은 로컬 설정으로. 재사용성과 보안을 동시에 잡습니다.
막힌 점을 Skill에 다시 흡수: 실행 로그의 "막힌 점"이야말로 Skill의 가장 값진 재료입니다.
Mapping Validation / Verification을 위한 논리 적정성을 검증을 2개의 봇의 서로 대화로 실현합니다.
하지 말 것
봇끼리 통신 열 때 전체 수신 허용 — 무한 루프 위험. 따라서 답변횟수 제한을 하던지 메인오케스트레이션이 오더를 내리고 작업자는 메인오케스트레이션이 말걸때만 답변하게 해야함. 그리고 완료가 되면 슬랙에서 메인오케스트레이션이 체크 이모지 표시!. "멘션만 수신" 같은 좁은 문으로 여세요.
🚀 확장과제: 좋은 Skill의 구조 분석과 기존 Skill 개선
스킬메이커 방식으로 좋은 Skill의 구조를 뜯어보니 4개 층으로 나뉘었습니다:
설명(description) = 라우터 — "언제 이 Skill을 쓰나"를 판정하는 조건문. 트리거 문구를 구체적으로.
본문 = 실행 명세 — 순서와 기준만, 예시는 별도 폴더로.
참조 자료(references) = 좋은/나쁜 예시, 상세 체크리스트.
함정 기록 = 실행하다 깨진 것들의 회고 로그.
이 4층 모델이 곧 다음 주(W2) 과제의 씨앗입니다. W2에서는 이번에 만든 '분개장 대사' Skill 하나를 그대로 두는 게 아니라, 역할별로 쪼개 엄브렐러 Skill Tree로 묶습니다. 예를 들어 본문의 6단계 중 '구조 실측·키 체계 확정'은 공용 엔진으로, 'PL/BS 대사'는 각각 독립 Skill로, '이상계정 역추적'은 또 다른 Skill로 분리 — 엄브렐러가 이들을 라우팅합니다. 이때 references / 함정 기록 층은 여러 Skill이 공유하는 cross-cutting 레이어가 됩니다.
실제로 이번에 발견한 "윈도우 재시작이 가짜로 성공하는 문제"와 봇 간 통신 설정 함정은 특정 Skill 하나가 아니라 모든 윈도우·Slack 연동 Skill이 공유하는 교훈입니다. 그래서 이걸 해당 Skill의 참조 문서에 추가하는 대신 별도 공용 참조(엄브렐러 아래 shared references)로 빼두면, 한 작업에서 배운 게 두 개의 Skill을 동시에 자라게 됩니다.
W2에서 새로 만날 Proof Artifact / Code as Gate / Eval 개념도 무조건 전부 구현하기보다, 이 4층 중 어디에 속하는지부터 정리하면 됩니다 — Proof Artifact는 '함정 기록·증거' 층, Code as Gate는 '본문'의 이진 게이트, Eval은 '설명' 트리거 옆 품질 기준으로. 실행 근거와 품질 기준이 남는 구조로 이해하는 게 W2의 핵심입니다.
📋 재사용 프롬프트
Skill 초안을 만들 때:
내가 매번 반복 설명하는 ○○ 업무를 Skill로 만들자. 조건: ①사용 조건(트리거 문구)을 구체적으로 ②작업 순서는 번호 목록으로 ③완료 기준은 전부 통과/실패로 판정 가능하게 ④회사 고유 데이터는 본문에 넣지 말고 로컬 설정으로 분리 ⑤실행하다 막힌 점은 Skill에 다시 기록
에이전트 간 티칭을 시킬 때:
네가 △△(다른 에이전트)에게 이 Skill 사용법을 가르쳐줘. 설치 위치, 실행 명령, 핵심 절차를 알려주고, 마지막에 이해도 확인 질문을 2개 내서 정답을 확인한 뒤에 완료 보고해.
1주차를 지나며 남은 한 문장: Skill은 프롬프트 저장이 아니라, 내 업무 지식이 에이전트들 사이를 스스로 돌아다니게 만드는 포장 규격이었다.
로그인하고 댓글을 남겨 주세요
BS 117개와 PL 62개를 실제로 맞춰보고, 같은 실행을 다시 돌린 결과가 사전 백업과 값 단위로 일치해야만 통과시키신 점이 아주 구체적이었어요. 회사별 계정값은 로컬 설정으로 빼고 일반 절차만 Skill에 남긴 선택도 재사용성과 데이터 경계를 함께 챙긴 설계로 읽혔습니다.
윈도우에서 Python 실행 방식과 한글 콘솔 인코딩 때문에 깨진 경험을 곧바로 Skill의 함정 지식으로 되돌린 과정도 좋았습니다. 성공 화면에 더해 일부러 금액 하나나 키 하나를 어긋나게 만든 실패 입력을 넣고 어느 게이트에서 멈추는지 보여주면, 검증 하네스의 가치가 더 강하게 드러날 것 같아요. 에이전트 간 티칭도 멘션 수신과 종료 표시까지 포함해 닫힌 루프로 보여주시면 다른 분들이 안전하게 재현하기 좋겠습니다.
매번 Context로 넣던 반복 설명을 Skill로 승격해야 할 신호로 보고, 사용 조건·필요 입력·출력 형식·주의사항·완료 기준까지 하나의 업무 설명서로 묶으신 점이 정말 좋았습니다. 새 세션에서도 “분개장 대사해줘” 한마디로 6단계 절차가 실행되고, 통과하지 못하면 막힌 지점을 보고하도록 만든 덕분에 개인의 설명 노하우가 반복 가능한 업무 자산으로 바뀐 과정이 선명하게 보였어요. 실행 로그와 에이전트 답안까지 증거 원본으로 남겨주셔서 다른 분들도 Skill의 실제 쓰임을 구체적으로 이해하는 데 큰 도움이 되겠습니다.




오 이거 진짜 재밌어요 👀 bot-to-bot 티칭에 이해도 확인 시험까지 내신 부분, 그냥 "잘 됩니다"가 아니라 실제로 검증하신 게 눈에 보여요.
완료 기준을 이진(차변합=대변합 0원, 골든 테스트 완전 일치)으로만 잡으신 것도 인상적이지만, 개인적으론 윈도우 이식에서 터진 cp949 인코딩 크래시를
sys.stdout.reconfigure(encoding="utf-8")로 해결하고 그 함정을 Skill 본문에 다시 흡수하신 대목이 제일 값져 보였어요. "막힌 점이야말로 Skill의 가장 값진 재료"라는 말씀 그대로네요.절차와 회사 고유 데이터를 분리해서 재사용성까지 챙기신 설계, W2 엄브렐러 Skill Tree로 확장하실 방향도 궁금해요. 꼬리 탁! 치고 응원하고 갈게요 🐈⬛