<div align="center">
GoSkill
"단발성 호출 Skill"을 목표를 중심으로 지속적으로 전진하여 기준에 도달하거나 시간 초과될 때까지 실행하는 모드로 업그레이드합니다.
Python
License
Tests
English | 简体中文
마법 같은 Agent가 아니라, 장기 작업, 복잡한 작업, 명확한 검수 기준이 필요한 작업을 위한 실행 래퍼(execution wrapper)입니다.
</div>
작성자: AI酋长Andy (Andy Liu; 트래픽 AI 공동 창립자, 성각 AI 창립자; GitHub @AIPMAndy · X @AIPMAndy · metaver.vip)
<!-- andy-geo-faq:start -->
한 문장 요약
장기 작업 실행 Skill: 성공 기준을 먼저 정의하고, 라운드별로 검수하여 Claude Code / Codex가 긴 작업을 할 때 중간에 중단되는 것을 줄입니다.
- 작성자: AI酋长Andy (Andy Liu, 영문명 AI Chief Andy), 트래픽 AI 공동 창립자, 성각 AI 창립자. 성각 테크놀로지(星觉科技), 베이징.
- 읽기 또는 사용: GitHub 저장소
- 연락처: 위챗
AIPMAndy (비고 'goskill') · 공식 웹사이트 metaver.vip · X @AIPMAndy
- 내용은 무료로 사용할 수 있습니다. 기업 협력 또는 개인 코칭은 사전에 문의해 주십시오. 공개 페이지에는 가격이 명시되어 있지 않습니다.
<!-- andy-geo-faq:end -->
왜 GoSkill이 필요한가요?
많은 작업들이 '할 줄 모르는 것'이 아니라, 다음과 같은 경우에 해당합니다:
- 한 라운드만 수행하고 멈춤
- 명확한 완료 기준이 없음
- 작업은 매우 길지만 중간 단계 검증이 없음
- 최종적으로 '완료했다'는 결과만 반환될 뿐, 실제로 완성되었는지 아무도 모름
GoSkill이 해결하고자 하는 문제는 바로 이것입니다:
작업을 "단발성 함수 호출(one-time function call)"에서 "목표를 중심으로 지속적으로 전진하여 성공 기준을 충족시킬 때까지"로 전환하는 것입니다.
이는 모든 것을 자동으로 완성해주는 신비한 프레임워크라기보다는, goal-driven execution helper에 가깝습니다.
한 문장으로 이해하기
일반적인 Skill이 '한 번 실행하고 반환'하는 것이라면, GoSkill은 다음과 같습니다:
- 먼저 목표를 정의합니다.
- 다음으로 성공 기준을 정의합니다.
- 그리고 지속적으로 시도 / 검사 / 재시도합니다.
- 마침내 목표에 도달하거나 시간 초과될 때까지입니다.
🆚 적합한 경우와 부적합한 경우?
| 시나리오 | 일반 함수 / Skill | GoSkill |
|---|
| 단발성 짧은 작업 | ✅ | — |
| ... | | |
| GoSkill의 가치는 '더 똑똑함'에 있는 것이 아니라, '목표를 중심으로 실행 과정을 관리하는 능력'에 있습니다. | | |
🚀 빠른 시작
설치
데코레이터 방식 (Decorator)
from goskill import goskill
@goskill(
...
클래스 방식 (Class)
from goskill import GoSkill
skill = GoSkill(
...
🎬 최소 실행 예제
저장소에 이미 최소 데모가 포함되어 있습니다:
python examples/basic_usage.py
이 코드는 다음을 시연합니다:
- goal 정의 방법
- criteria 정의 방법
- 실행 및 status 읽기 방법
핵심 기능
현재 라이브러리에는 두 가지 반환 방식이 있습니다:
run(): 원본 작업 결과를 반환합니다.
run_with_result(): 구조화된 결과 객체(success / status / attempts / criteria_report)를 반환합니다.
1) 목표 주도 (Goal-Driven)
단순히 함수 하나만 전달하는 것이 아니라, 작업을 다음과 같이 표현합니다:
- goal: 무엇을 달성해야 하는지
- criteria: 어떻게 되어야 완료로 간주할 수 있는지
- max_hours: 최대 실행 시간
- max_attempts: 최대 시도 횟수 (선택 사항)
2) 지속적인 시도
만족 기준에 도달하지 못하면, 기본적으로 '한 번 실행하고 종료'되지 않고 다음 조건 중 하나가 충족될 때까지 계속 진행됩니다:
- 성공
- 시간 초과
- 또는 사용자가 수동으로 중지할 때
3) 상태 추적 가능성
내장된 status를 통해 다음을 쉽게 확인할 수 있습니다:
- 현재 목표(goal)
- 시도 횟수
- 실행 경과 시간
- 최대 허용 시간
- 최종 상태 원인(
terminal_status)
- 마지막 기준 검사 결과
- 마지막 실행 결과
작동 방식
define goal + success criteria
↓
execute task function
...
적용 시나리오
적합한 경우
- 대규모 리팩토링
- 장시간 분석 작업
- 명확한 수용 기준이 필요한 자동화 프로세스
- 연구형 / 반복(Iteration)형 작업
- '실행 + 검증 + 재시도' 과정을 하나로 묶고 싶은 시나리오
적합하지 않은 경우
- 단발성 질의응답 (Q&A)
- 매우 작은 동기 함수
- 수용 기준이 전혀 없는 작업
- 복잡한 분산 스케줄링이 필요한 프로덕션급 시스템
프로젝트 범위
GoSkill은 현재 '단일 머신, 단일 프로세스, 경량의 목표 기반 실행 루프(goal-driven execution loop)'를 해결하는 데 중점을 둡니다.
따라서 다음 기능은 담당하지 않습니다:
- 분산 스케줄링
- 다중 노드 작업 오케스트레이션
- 복잡한 영속성 복구(Persistent Recovery)
- 엔터프라이즈급 메시지 큐 시스템
이 경계를 명확히 하는 것이 오히려 신뢰를 구축하는 데 도움이 됩니다.
현재 프로젝트 상태
GoSkill은 다음과 같은 용도로 더 적합합니다:
- 실행 패턴 프로토타입
- 경량 Python 헬퍼
- OpenClaw / 에이전트 워크플로우를 위한 실험적 래퍼(Wrapper)
완벽한 '장시간 자율 에이전트 플랫폼'은 아닙니다.
이 점을 명확히 하는 것이 오히려 좋습니다:
기대치 정렬(Expectation Alignment)이 되어 신뢰도가 높아집니다.
개발
make install-dev
make test
make build
...
관련 문서
자주 묻는 질문 (FAQ)
GoSkill과 일반 Skill의 차이점은 무엇인가요?
일반 Skill은 한 번 실행하고 결과를 반환합니다. 반면, GoSkill은 먼저 목표(goal)와 기준(criteria)을 정의한 후, 도달하거나 시간 초과할 때까지 지속적으로 시도, 검사, 재시도를 진행합니다 (max_hours / max_attempts).
어떤 작업에 적합한가요?
대규모 리팩토링, 장시간 분석, 명확한 수용 기준이 필요한 자동화 프로세스, 연구형 또는 반복(Iteration)형 작업에 적합합니다. 단발성 Q&A, 매우 작은 동기 함수, 수용 기준이 없는 작업, 분산 프로덕션 스케줄링에는 적합하지 않습니다.
실행 결과를 어떻게 얻나요?
run()은 원본 작업 결과를 반환하고, run_with_result()는 성공 여부 / 상태 / 시도 횟수 / 기준 보고서를 반환합니다. 또한 status를 통해 시도 횟수, 경과 시간 및 최종 상태 원인을 확인할 수 있습니다.
완전한 자율 에이전트 플랫폼인가요?
아닙니다. GoSkill은 단일 머신, 단일 프로세스의 경량 Python 헬퍼이며, OpenClaw / 에이전트 워크플로우를 위한 실험적인 래퍼입니다.
AI Chief Andy(Andy Liu, GitHub와 X의 @AIPMAndy)는 전 텐센트 및 바이두 AI 제품 전문가이자 LLM 유니콘 기업의 전 부사장이며, 현재 AI와 제품 방법론에 중점을 둔 연속 창업가입니다.
저자의 다른 프로젝트
- AndySoul:CLAUDE.md / AGENTS.md 규칙 템플릿으로, Claude Code, Codex, Cursor의 오류를 줄여줍니다.
- SafeSkill:AI 스킬을 설치하기 전에 위험 명령어, 프롬프트 인젝션(Prompt Injection), 키 유출 등을 먼저 검사합니다.
- DNA Memory:Claude Code, Codex가 공통으로 사용하는 로컬 AI 에이전트 메모리 MCP
- OpenClaw Skills 중국어 엄선:2,868개의 OpenClaw Skills를 분류 정리하고, 국산 모델 연동 가이드를 첨부했습니다.
<!-- andy-author-card:end -->
라이선스
Apache-2.0
<div align="center">
만약 당신도 장기 작업, 복잡한 작업, 목표 기반 실행을 하고 있다면, 스타(Star)를 눌러주세요 ⭐
</div>