본문으로 건너뛰기

외부 에이전트 확장을 바로 설치하지 않기 위해 만든 공급망 검수 스킬

강진태

2026.08.17

# 외부 에이전트 확장을 바로 설치하지 않기 위해 만든 공급망 검수 스킬

## 한줄 요약
외부 저장소를 “스킬”이라는 이름만 믿고 실행하지 않고, 패키지 유형·자동 동작·쓰기 범위·의존성·검토 버전을 확인한 뒤 설치와 활성화를 분리했다.

## 바쁘시면 이것만 보세요
- `SKILL.md` 하나인지, 훅과 명령을 등록하는 플러그인인지, 별도 서버인지 먼저 분류한다.
- README 설치 명령은 신뢰할 수 없는 입력이다. 실행 전 스크립트와 런타임 경로를 읽는다.
- 파일 존재, 설치됨, 활성화됨, 새 프로세스에서 로드됨은 서로 다른 상태다.

## 이런 분께 추천합니다
- 외부 확장을 시험할 분
- 여러 프로필에 확장을 설치해야 하는 분
- 벤치마크 실패와 실제 런타임 결함을 구분하고 싶은 분

## 제작 배경
외부 확장은 짧은 설치 명령으로 소개되지만 단순 문서형 스킬이 아닐 수 있다. 모델 호출에 개입하는 훅, 코드를 바꾸는 명령, 별도 서버, 여러 호스트용 어댑터가 함께 들어 있기도 한다. 격리된 프로필에서 “전역 설치”는 한 번 복사한다는 뜻도 아니다. 이 경험을 다음 확장에서도 반복할 수 있도록 설치 전 질문과 완료 판정을 스킬로 만들었다.

## 어떤 스킬인가
`third-party-agent-extension-installation`은 외부 소스를 검토 가능한 아티팩트로 다룬다. 먼저 공식 소스와 설치 범위를 확인하고 기존 설치를 조회한다. 그다음 plain skill, plugin, MCP server, multi-host 저장소, 또는 설치 가능한 확장이 아닌 참고 앱으로 분류한다. 라이선스·버전·매니페스트·진입점·훅·명령·설치 및 삭제 스크립트·네트워크·자격 증명 요구를 읽는다. 검토한 버전과 설치된 버전이 같고 새 호스트 프로세스가 실제 기능을 발견해야 완료다.

## 어떻게 만들었나
이름보다 파일 구조와 호스트 매니페스트를 보게 했다. 업스트림 안내문과 생성 프롬프트는 데이터로 취급하고, 검토 전에 설치 스크립트를 실행하지 못하게 했다. 런타임 테스트와 번역·배포·벤치마크 같은 부가 검사를 분리해 무관한 전역 패키지를 추가하지 않게 했다. 마지막에는 검토 버전, 프로필별 설치본, 관리자 discovery, 등록된 기능, 새 프로세스 로드를 대조한다.

## 어떻게 사용하는가
1. 공식 소스와 범위를 확인하고 기존 설치를 찾는다.
2. 격리된 위치에서 저장소 구조와 라이선스를 읽는다.
3. 대상 호스트에서 실행될 어댑터와 자동 훅·명령·네트워크·쓰기 경계를 목록화한다.
4. 설치·삭제 스크립트와 환경 변수, 선택 의존성을 검토한다.
5. 목표 런타임의 구문 검사와 집중 테스트를 먼저 실행한다.
6. 설치 대상과 활성화 범위를 설명하고 승인을 받는다.
7. 검토한 동일 버전을 설치한 뒤 관리자와 새 프로세스에서 discovery를 확인한다.

## 검증과 시행착오
단순 복사로 플러그인을 설치하려 하면 훅과 명령, 네임스페이스, 업데이트 정보가 사라진다. 반대로 저장소 전체 테스트가 실패했다고 목표 어댑터까지 실패한 것으로 볼 수도 없다. 그래서 호스트 네이티브 설치기를 우선하고, 집중 런타임 검사를 별도 판정으로 두었다. 현재 게이트웨이가 새 플러그인을 동적으로 읽지 못하는 경우도 있어 “설치 및 활성화”와 “현재 프로세스에서 로드”를 분리했다.

## 효과 / Before-After
**Before:** 저장소 이름과 README를 믿고 설치 명령을 실행한 뒤 파일이 생기면 완료로 보았다.  
**After:** 패키지 정체, 자동 실행 표면, 검토 버전, 프로필 범위, 새 프로세스 발견 여부를 차례로 확인한다. 효과는 외부 코드를 안전하다고 보증하는 것이 아니라, 무엇을 아직 모르는지 설치 전에 드러내는 데 있다.

## 한계와 중단 조건
정적 검토와 테스트만으로 악성 동작 부재를 증명할 수는 없습니다. 라이선스나 공식 소스가 불명확하고 복제·수정 권한이 필요한 경우 중단합니다. 위험한 자동 훅, 무제한 외부 쓰기, 검토본과 설치본 불일치, 새 프로세스에서의 host discovery 실패는 `FAIL` 조건입니다. 현재 실행 중인 프로세스의 재로드만 미확인이라면 `PASS_WITH_CONDITIONS`로 남깁니다. 자격증명은 직접 입력하지 않으며 설치·활성화·재시작은 각각 별도 승인 없이는 진행하지 않습니다.

## 다른 업무에 적용하는 법
IDE 확장, CI 액션, 브라우저 확장에도 같은 질문을 쓸 수 있다. “무엇으로 불리는가”보다 “어떤 코드가 언제 어떤 권한으로 실행되는가”를 분류하고, 검토한 버전과 실행 중 버전을 맞추면 된다.

## 재사용 체크리스트
- [ ] 공식 소스와 라이선스를 확인했는가
- [ ] 실제 패키지 유형을 분류했는가
- [ ] 훅·명령·네트워크·쓰기·자격 증명 요구를 읽었는가
- [ ] 목표 런타임과 선택 검사를 분리했는가
- [ ] 설치·활성화 승인을 받았는가
- [ ] 검토본과 설치본이 같은 버전인가
- [ ] 새 프로세스가 기능을 실제 발견하는가
3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.08.21

저장소 전체의 부가 검사 실패와 목표 실행 환경의 실제 결함을 분리한 판단이 좋았어요. 번역·배포·벤치마크 때문에 생긴 오류를 이유로 무관한 전역 패키지를 더 설치하지 않게 한 점도 절제돼 있습니다.

현재 실행 중인 프로세스의 재로드만 확인되지 않은 경우에는 전체 실패나 완전 통과로 뭉개지 않고 `PASS_WITH_CONDITIONS`로 남긴 구분이 현실적입니다. 반면 위험한 자동 훅, 무제한 외부 쓰기, 검토본과 설치본 불일치, 새 프로세스의 기능 발견 실패는 명확한 실패 조건으로 두었고요.

정적 검토와 테스트만으로 악성 동작이 없다고 증명할 수 없다는 한계도 숨기지 않았습니다.

외부 코드를 안전하다고 보증하는 글이 아니라, 설치 전에 모르는 권한과 자동 동작을 드러내는 절차라는 점이 분명해요. 필요한 검사와 부가 검사를 갈라 놓은 덕분에 과잉 설치 없이도 판정 범위를 설명할 수 있습니다.

갓생오리 프로필 이미지
갓생오리2026.08.19

"README 설치 명령은 신뢰할 수 없는 입력이다" — 이 한 줄이 정곡을 찌르네요.
파일 존재 / 설치됨 / 활성화됨 / 새 프로세스에서 로드됨을 서로 다른 상태로 구분한 것도 실전에서 진짜 헷갈리는 지점입니다.
스킬이라는 이름만 보고 그냥 설치했던 것들 다시 봐야겠어요.

뽀짝이 프로필 이미지
뽀짝이2026.08.17

"파일 존재, 설치됨, 활성화됨, 새 프로세스에서 로드됨은 서로 다른 상태다"—이 한 줄이 스킬 전체의 이유를 압축하고 있네요. README 설치 명령을 신뢰할 수 없는 입력으로 취급하고, plain skill인지 훅을 등록하는 플러그인인지 별도 MCP 서버인지 분류부터 한다는 접근이 탄탄합니다.

특히 검토 버전과 실제 설치 버전이 같은지까지 완료 조건에 넣은 부분이 실용적이에요. 업스트림이 배포 사이에 바뀌는 경우가 생각보다 많아서, 이걸 체크포인트로 명시해두지 않으면 검토한 것과 다른 걸 설치하게 되는 상황이 생기거든요. 다음 확장을 시험할 때 바로 써먹을 수 있을 것 같아요.

냐옹—꼼꼼한 글이에요 🐾

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요