AI 기술은 프롬프트 모음이 아닌 이식 가능한 역량 자산이어야 합니다

오늘의 Doramagic 지표에서 나타난 두 번째 신호는 또 다른 브라우저 자동화 팩이 아니었습니다. 그것은 바로 doramagic-skills였습니다. 2026-05-20 샘플에서 해당 리포지토리(repo)는 35회의 조회수, 8명의 고유 방문자, 10회의 클론(clone), 10명의 고유 클로너를 기록했습니다. 흥미로운 점은 방문자들이 리포지토리 홈에서 멈추지 않았다는 것입니다. 그들은 또한 다음과 같은 특정 기술(skill) 파일들을 열어보았습니다: skills/economic-dashboard/human_summary.md, skills/qlib-ai-quant. 이러한 행동은 중요합니다. 이는 사람들이 특정 작업에 해당 기술이 유용한지 확인하고 있다는 것을 의미합니다.

프롬프트만으로는 충분하지 않습니다
많은 AI 기술들이 그저 프롬프트 조각(prompt snippets)에 불과합니다: '이 전문가처럼 행동하세요', '이 단계들을 따르세요', '이 형식을 반환하세요', '이러한 실수를 피하세요'와 같은 것들 말입니다. 그것이 유용할 수는 있지만, 아직 이식 가능한 역량 자산(portable capability asset)은 아닙니다. 만약 기술이 단 하나의 채팅, 하나의 모델, 또는 하나의 도구에서만 작동한다면 유지보수하기 어렵습니다. 만약 트리거 조건(trigger conditions), 검증 경로(validation path), 그리고 실패 경계(failure boundary)가 없다면, 그것은 사용자들이 신뢰하기 주저하게 되는 또 다른 텍스트 조각이 될 뿐입니다.

이식 가능한 기술에 필요한 것
재사용 가능한 기술은 최소한 네 가지 질문에 답할 수 있어야 합니다. 첫째, 어떤 작업을 해결하는가? 구체적인 것이 추상적인 것보다 낫습니다. "경제 대시보드 요약을 생성하라"는 "AI가 경제를 이해하게 하라"보다 더 유용합니다. 둘째, 언제 트리거되어야 하는가? 기술은 자신을 활성화하는 입력값(inputs), 실행되지 말아야 할 케이스, 그리고 에이전트(agent)를 중단시켜야 하는 누락된 데이터에 대해 설명해야 합니다. 셋째, 결과가 어떻게 검증되는가? 에이전트의 응답은 완료된 작업과 동일하지 않습니다. 기술은 생성된 파일, 데이터 소스, 명령(commands), 수락 기준(acceptance criteria), 그리고 실패 노트와 같은 증거를 남겨야 합니다. 넷째, 호스트(hosts) 간에 이동할 수 있는가? 동일한 역량은 Codex, Claude Code, Cursor, Aider 또는 다른 AI 코딩 호스트에 쉽게 적응할 수 있어야 합니다. 이것이 바로 Doramagic이 기술을 다음과 같은 번들(bundle)로 취급하는 이유입니다: 사용자 매뉴얼(human manual), 호스트 지침(host instructions), 프롬프트 미리보기(prompt preview), 평가 체크리스트(eval checklist), 알려진 함정(known pitfalls), 소스 맵(source map), 경계 및 리스크 카드(boundary and risk card). 목표는 더 많은 프롬프트를 수집하는 것이 아닙니다.

목표는 사람들이 로드(load), 재사용(reuse), 검증(verify) 및 개선(improve)할 수 있는 AI 역량(capabilities)을 소유할 수 있도록 돕는 것입니다. 프로젝트: https://github.com/tangweigang-jpg/doramagic-skills 이것은 Doramagic에서 준비한 비공식 AI 역량 콘텐츠입니다. 상위 프로젝트(upstream project)에서 명시적으로 달리 언급하지 않는 한, 이것은 공식적인 상위 프로젝트 릴리스(upstream release)가 아닙니다.