ONEDEV

Agent-Loop-Skills

gaasher파일 153개

★ 169주당 +2조회 5

무엇인가

Agent-Loop-Skills는 작업을 단일 응답으로 끝내지 않고, 변경 제안 → 실행 → 채점 → 유지 또는 되돌리기 → 종료 판정의 반복 루프로 수행하도록 강제하는 규칙 묶음이다. 자율 연구, 과학 글쓰기, 데이터 분석, 코드·SQL·프롬프트 최적화, 레드·블루·퍼플팀 훈련처럼 정답이 한 번에 나오지 않는 탐색적 작업 영역을 규율한다. 각 항목은 특정 과제용이 아니라 호출 시점에 사용자 과제에 결합되는 일반 루프다.

어떻게 동작하나

구조는 루프마다 SKILL.md 하나와 소량의 YAML 프런트매터다. 모든 루프는 다섯 요소로 분해된다. program(SKILL.md), 개선 대상인 artifact 슬롯, 다음 단계를 결정하는 feedback signal, append-only run ledger, 종료 조건. 발동은 명시적 슬래시 명령이 아니라 호스트의 자동 로드다. 사용자가 과제를 서술하면 호스트가 관련 루프를 골라 로드한다. Claude Code에서는 플러그인으로 설치되어 `agent-loops:` 네임스페이스가 붙고, 다역할 루프는 spawn-or-degrade 방식으로 Claude Code에서는 격리된 서브에이전트를, 다른 호스트에서는 같은 역할을 인라인으로 실행한다.

무엇과 다른가

과제 특화 스킬이나 프롬프트 직접 작성과의 차이는 루프의 골격을 스킬 쪽에 고정한다는 점이다. 프롬프트를 직접 쓰면 매번 종료 조건과 검증 신호를 다시 설계해야 하지만, 여기서는 검증 신호(테스트, 지연시간, 지표, 보정된 판정자)와 종료 조건(정체·예산·임계값)이 스킬에 내장되어 있다. 또한 무거운 의존성을 싣지 않는다. torch 트레이너, SQL 데이터베이스, 데이터셋 같은 실제 코드는 사용자 환경에서 바인딩된 실행 명령으로 돌고, 스킬은 셸로 호출해 결과만 읽는다.

어떻게 쓰나

설치는 세 가지 경로 중 하나를 쓴다. Claude Code는 `/plugin marketplace add gaasher/agent-loop-skills` 후 `/plugin install agent-loops@agent-loop-skills`, 범용 호스트는 `npx skills add gaasher/agent-loop-skills` 또는 `gh skill install gaasher/agent-loop-skills --agent <host>`, 수동은 저장소를 클론해 `loops/*`를 `~/.claude/skills/` 또는 `~/.agents/skills/`로 복사한다. 첫 사용은 설치 후 과제를 서술하는 것으로 시작한다. 연구 계열 루프는 공유 `literature-search` 스킬을 함께 호출하므로 전체를 설치하는 편이 낫고, 없으면 WebSearch로 저하 동작한다.

전제와 한계

전제는 검증 가능한 피드백 신호가 존재한다는 것이다. 신호가 없으면 루프가 성립하지 않는다. Claude Code에서 네이티브로 돌고 Codex·Cursor 등 Agent Skills 호스트로 이식되지만, 호스트별로 다역할 실행 방식과 자동 로드 동작이 달라진다. 비지도 루프는 단계 정확도 90%에서 5단계 체인이 약 40% 실패할 수 있으며, 저장소는 이를 전제로 모든 루프에 검증 게이트와 명시적 종료 조건을 둔다. 저장소의 CIFAR-10 수치는 의도적으로 작은 CNN·5에폭 예산의 데모로, 절대 정확도가 아니라 루프의 의사결정을 보여주는 값이다.

관련 논문 3

유사 스킬