고급 수명 주기 제어 및 worktree 관리를 통해 백그라운드 AI 코딩 세션을 관리하기 위한 전문 오케스트레이션 레이어입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install code-agent-orchestration
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 code-agent-orchestration 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Code Agent Orchestration란 무엇인가요?
Code Agent Orchestration은 Claude Code 또는 Codex 세션을 백그라운드 코딩 작업으로 관리하도록 설계된 Openclaw Skills 에코시스템 내의 강력한 도구입니다. 개발자에게 채팅 컨텍스트를 떠나지 않고도 다회차 에이전트 세션을 시작하고, 계획 승인을 처리하며, 복잡한 git worktree 전략을 관리할 수 있는 강력한 프레임워크를 제공합니다.
이 기능을 활용하면 개발자는 자율 에이전트를 심도 있게 제어할 수 있습니다. 이는 순수 AI 실행과 인간의 개입(human-in-the-loop) 감독 사이의 간극을 메워, 코드 변경 사항이 엄격한 보안 및 아키텍처 가이드라인에 따라 계획, 검토 및 병합되도록 보장합니다.
Code Agent Orchestration 활용 사례
- 대규모 저장소에서 백그라운드 리팩토링 작업을 오케스트레이션합니다.
- 에이전트가 실행 전 검토를 위해 아키텍처 변경 사항을 제출해야 하는 'Plan-First' 워크플로우를 구현합니다.
- 워크스페이스 오염을 방지하기 위해 자동화된 git worktree를 사용하여 격리된 개발 샌드박스를 관리합니다.
- 세션 컨텍스트를 잃지 않고 중단된 코딩 세션을 재개하거나 후속 작업을 처리합니다.
- 복잡한 PR 결정은 개발자에게 에스컬레이션하면서 저위험 병합을 자동화합니다.
Code Agent Orchestration 작동 원리
- 세션 시작: 오케스트레이터가
agent_launch를 사용하여 에이전트 세션을 초기화하고 워크스페이스 및 권한 모드를 정의합니다. - 계획 생성: 'plan' 모드에서 에이전트는 기술 제안서를 생성하며, 이는 정의된 승인 전략에 따라 검토를 위해 대기합니다.
- 승인 수명 주기: 설정(Ask, Delegate, Approve)에 따라 계획이 자동 검증되거나 오케스트레이터에 의해 검토되거나 사용자에게 전송됩니다.
- 실행: 승인되면 에이전트는 대상 디렉토리 또는 전용 worktree 내에서 코딩 작업을 실행합니다.
- 모니터링 및 피드백: 오케스트레이터는 실시간 출력 및 결정론적 상태 필드를 모니터링하여 진행 상황을 추적하고 에이전트 문의를 처리합니다.
- 워크트리 확인: 완료 후 시스템은 merge 또는 PR 명령을 통해 샌드박스 worktree에서 메인 브랜치로의 전환을 관리합니다.
Code Agent Orchestration 설정 가이드
Openclaw Skills 환경 내에서 이 기능을 시작하려면 OpenClaw CLI가 설치되어 있는지 확인한 다음 code agent 패키지를 추가하세요.
# OpenClaw code agent 패키지 설치
npm install openclaw-code-agent
# 설치 확인
openclaw --version
구성 구성은 주로 채팅 세션 중 workdir 및 permission_mode 설정과 같은 도구 호출을 통해 처리됩니다.
Code Agent Orchestration 데이터 스키마 및 분류 체계
이 기능은 결정론적 메타데이터 스키마를 사용하여 세션 데이터와 worktree 상태를 구성합니다. 주요 상태 필드는 다음과 같습니다.
| 필드 | 설명 |
|---|---|
requestedPermissionMode |
요청된 초기 권한 게이트 (예: plan, bypass). |
approvalExecutionState |
세션이 awaiting_approval 상태인지 또는 approved_then_implemented 상태인지 추적합니다. |
worktree_status |
pending_decision, merged, released와 같은 샌드박스 수명 주기 상태를 모니터링합니다. |
session_id |
다회차 상호작용 재개를 위한 고유한 kebab-case 식별자. |
Code Agent Orchestration 고급 기능
- 위임 승인: 오케스트레이터가 구조화된 근거를 제공하면서 저위험 계획을 프로그래밍 방식으로 승인할 수 있도록 합니다.
- 워크트리 격리: 실험적 코드를 임시 작업 샌드박스에 유지하기 위해
delegate및askworktree 전략을 지원합니다. - 상태 기반 모니터링: 불안정한 트랜스크립트 파싱 대신 결정론적 필드를 사용하여 에이전트의 완료 및 성공 여부를 확인합니다.
- 안전한 정리: 활성 PR이나 더티 브랜치를 잃지 않고 오래된 worktree를 정리하는 고급
preview_safe및clean_safe모드. - 다회차 연속성: 긴 작업이 여러 상호작용에 걸쳐 전체 컨텍스트를 유지하도록
resume_session_id를 기본적으로 지원합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Threads Automation Suite (threads-skills)
Chrome CDP 및 Python으로 구동되는 Threads 플랫폼용 전문 자동화 툴킷입니다.
MX Stocks Screener
Eastmoney Miaoxiang 데이터베이스를 사용하여 자연어로 글로벌 주식, 펀드 및 채권을 필터링하는 AI 기반 금융 스크리닝 도구입니다.
mx-macro-data
Eastmoney 데이터베이스에서 구조화된 거시 경제 및 원자재 가격 데이터를 검색하기 위한 자연어 인터페이스입니다.
금융 정보 검색 (mx-finance-search)
Eastmoney 데이터베이스를 통해 글로벌 금융 공시, 연구 보고서 및 시장 뉴스에 실시간으로 접근할 수 있는 자연어 검색 도구입니다.
ClawVitals
ClawVitals는 Openclaw 설치 환경을 스캔하여 취약점을 식별하고 점수화된 안전 보고서를 제공하는 보안 상태 점검 스킬입니다.
METADATA
추천*
