AI 스킬을 Agensi에 배포하기 위해 수정한 출력 위치와 테스트

2026년 10월 7일, 일본의 토지 가격 1차 검토를 지원하는 'tochi-satei-kun'이 Agensi에 게재되었습니다. 무료로 다운로드할 수 있습니다. 이 글에서는 먼저 동봉된 샘플을 구동하는 절차를 소개하고, 그 후에 배포 시 수정한 출력 위치와 테스트를 설명합니다.

Agensi는 AI 에이전트용 스킬을 찾아 얻을 수 있는 해외 마켓플레이스입니다. 작업 진행 방법이나 실행 절차를 정리한 스킬이 무료 및 유료로 공개되어 있습니다. 개발자에게는 제작한 스킬을 사용자에게 전달하는 배포처 중 하나입니다.

Agensi

Agensi 게재 페이지에서 배포 ZIP을 가져와 압축을 해제합니다. 아래는 Python을 실행할 수 있는 환경에서, 압축 해제된 폴더의 상위 디렉토리부터 시작하는 절차입니다. 의존 패키지는 requirements.txt에서 확인할 수 있습니다. 필요에 따라 전용 가상 환경을 준비해 주세요.

배포 페이지

cd tochi-satei-kun

python -m pip install -r requirements.txt

python scripts/main.py samples/sample_property.json samples/sample_mlit.csv samples/sample_koji.csv --json-out output/sample_result.json

이 예시에서는 물건 조건, 부동산 거래 가격 샘플, 공시 가격 샘플을 전달하고, JSON 저장 위치도 지정했습니다. 예상되는 출력은 다음 두 가지입니다.

・Excel: output/土地査定_MIN001_20260501.xlsx

・JSON: output/sample_result.json

동봉된 샘플은 합성 데이터입니다. 먼저 확인할 것은 입력을 읽어 지정한 위치에 결과물을 생성할 수 있는지 여부입니다. 샘플의 결과를 실재하는 물건의 가치나 추정 정확도의 근거로 사용할 수는 없습니다.

이 글은 Agensi 배포 버전을 대상으로 합니다. 작성 시점에서는 아래에서 설명하는 출력 위치 수정 사항이 GitHub 공개 버전에는 반영되지 않았습니다. 재현 확인에는 위의 배포 ZIP을 사용해 주세요.

tochi-satei-kun은 일본의 토지를 대상으로 하는 1차 검정 도구입니다. 부동산 거래 가격 정보 CSV를 기반으로 헤도닉 회귀의 계수

CLI 실행 후 데스크톱으로 복사하는 처리는 --copy-to-desktop을 지정했을 경우에만 실행됩니다. 평소 실행 시, 사용자가 의도하지 않은 장소에 복사가 늘어나는 것을 방지하기 위함입니다.

참고로, 사용자가 명시적으로 선택하는 저장 위치는 작업 디렉토리 외부일 수도 있습니다. 이번 변경은 기본 동작을 정리한 것이며, 파일 시스템 접근을 제한하는 샌드박스는 아닙니다.

코드 변경에 맞춰 사람이 읽는 README와 AI 에이전트가 읽는 SKILL.md도 업데이트했습니다. 설명서에 오래된 저장 위치가 남아 있으면, 처리가 성공했더라도 실행 후 결과물을 찾는 장소를 잘못 알게 하는 원인이 됩니다.

개발 환경에서는 45개의 pytest를 통과했습니다. 게다가 작업 디렉토리 외부의 입력 파일을 사용하는 CLI 실행과, 배포 ZIP을 전개한 상태에서의 실행도 확인했습니다. 특히 확인한 것은 다음 동작들입니다:

・외부 입력 파일을 읽어올 수 있음

・Excel 출력 위치를 생략하면, 실행 위치의 output에 저장됨

・CLI의 일반 실행에서 데스크톱으로 복사가 발생하지 않음

・배포 ZIP을 전개한 후에도 같은 흐름으로 실행할 수 있음

Windows의 깊은 계층 경로에서도 xlsx 생성은 확인했지만, Excel 앱으로 열어보는 것까지는 확인하지 못했습니다. 파일 생성과 앱 상에서의 표시는 별도의 검증 항목입니다. 또한, 테스트 통과 건수는 부동산 가격 추정의 정확도를 보장하는 지표가 아닙니다.

배포 ZIP에는 SKILL.md, README, requirements.txt, LICENSE, NOTICE, 스크립트, 합성 데이터 샘플 등을 포함하고 있습니다. pytest 테스트 코드, 실행 결과, 캐시, .git 등은 포함하지 않았습니다. 위 45개의 테스트는 개발 환경에서 실시한 것이며, ZIP만으로 그 테스트 일체를 실행할 수 있는 구성이 아닙니다.

사용자가 받는 ZIP을 전개하여 작동시켜 보면, 필요한 파일 누락이나 개발 환경에만 의존하는 문제를 쉽게 확인할 수 있습니다. 코드의 테스트와 배포물의 테스트를 분리해 두는 것이 중요합니다.

GitHub 공개 소스에는 Apache License 2.0의 LICENSE와 NOTICE가 있습니다. Agensi에서의 이용 및 배포에는 같은 플랫폼의 적용 조건도 있으므로, 각각 확인해 주십시오.

입력원, 작업 디렉토리, 출력처를 별도로 결정함

• 생략 시 동작과 명시 지정했을 경우의 동작을 설명함

• 코드와 README, SKILL.md를 동시에 업데이트함

• 개발 환경 외에 배포 ZIP을 전개한 상태에서도 작동시킴

Agensi에 게재 심사를 통과하는 것이 추정 정확도나 안전성의 인증을 의미하지 않습니다. 이용 환경에서 동작을 확인하고, 전문 업무상의 판단은 별도로 해야 합니다.

우선은 배포판 샘플로 출력처와 Excel 내용을 확인해 보시기 바랍니다.

GitHub 공개 소스

국토교통성 지가공시 데이터 L01