Community코딩 & 개발github.com

Argus 런타임 오케스트레이션

휴대용 외부 연산자 절차를 제공하여 5개의 호스트에서 내구성 있는 Argus 임무를 실행합니다.

Argus 런타임 오케스트레이션란 무엇인가요?

이 스킬은 지속적인 상태, 아티팩트, 실험, 백그라운드 실행, 독립적 검토, 일시 중지/재개, 또는 단일 모델 턴을 넘어서는 연속 작업이 필요한 복잡한 AI 에이전트 작업을 위해 설계된 휴대용 런타임 오케스트레이션 절차입니다. Argus는 내구성 있는 감독 시스템으로 계획, 실행, 검토, 상태 유지, 질문 표면화, 증거 및 아티팩트 생성을 담당합니다. 외부 연산자(OpenClaw, Hermes Agent, Claude Code, Codex CLI, Copilot CLI 등)는 임무를 준비하고, Argus를 시작 및 관찰하며, 위임된 권한 내에서 연산자 질문을 처리하고, 아티팩트를 검증합니다. 이 절차는 네이티브 셸 명령, HTTP API, 그리고 'Needs you' 카드 기반 질문 루프를 통해 여러 호스트와 어댑터(Copilot CLI, Hermes Agent, Claude Code)를 지원하며, 견고한 오류 처리, 복구, 프라이버시 보호를 강조합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/Argus-AiTeam/argus-counterexample-runtime/tree/HEAD/integrations/agent-skills/argus-runtime-orchestration

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Argus 런타임 오케스트레이션은(는) 무엇을 하나요?

지속적인 상태, 아티팩트, 실험, 백그라운드 실행, 독립적 검토, 일시 중지/재개, 또는 단일 모델 턴을 넘어서는 연속 작업이 필요한 작업에 사용하세요. 빠른 답변, 단순 읽기 전용 검사, 또는 현재 호스트가 안전하게 완료하고 직접 검증할 수 있는 소규모 작업에는 사용하지 마십시오.

알려진 제한 사항

  • Argus는 Needs you에서 모든 외부 연산자로의 보편적으로 휴대 가능한 푸시/콜백을 제공하지 않습니다. 외부 연산자는 의미 있는 경계에서 간결한 Argus 상태/출력을 적극적으로 검사해야 합니다. 호스트가 내구성 있는 모니터링을 유지할 수 없는 경우 개입 감지가 실시간이 아닐 수 있으며, 이 스킬은 해당 경우에 무인 감독을 주장하는 것을 금지합니다.
  • Hermes Agent 및 Claude Code 어댑터는 현재 이 호스트에서 로컬 실행 테스트가 아닌 문서 검증 상태입니다.
  • 현재 문서의 일부 Copilot CLI 스킬 명령어는 로컬에서 테스트된 1.0.39 빌드에 없으므로 기능 감지가 필요합니다.

양방향 운영 모델 및 구성

정확히 두 개의 운영 주체가 있습니다:

  1. 외부 연산자(Outer operator): OpenClaw, Hermes Agent, Claude Code, Codex CLI, Copilot CLI 또는 이 스킬을 따르는 기타 셸 가능 에이전트. 임무를 준비하고, Argus를 시작 및 관찰하며, 위임된 권한 내에서 연산자 질문을 처리하고, 아티팩트를 검증하며, 간결하게 보고합니다.
  2. Argus: 계획, 실행, 검토, 상태 유지, 질문 표면화, 증거 및 아티팩트를 생성하는 내구성 있는 감독 시스템.

Argus가 내부적으로 사용하는 모든 모델/제공자 CLI(예: codex, copilot, claude, pi, opencode, grok)는 Argus 구성 및 구현 세부 사항이며, 이 절차에서 제3의 역할, 동료 행위자 또는 별도의 주체가 아닙니다. 외부 연산자는 운영상 필요하고 권한이 있을 때 사전 점검 중에 Argus의 구성된 내부 모델/제공자를 선택하거나 확인할 수 있습니다. 그 외에는 Argus를 하나의 내구성 있는 감독 시스템으로 취급합니다. 이름이 우연히 일치하더라도 외부 연산자의 신원에서 Argus 구성을 추론하지 마십시오.

실행 파일을 명시적으로 확인하십시오. 하나의 보편적인 설치 경로를 가정하지 마십시오. POSIX 셸:

if [ -n "${ARGUS_BIN:-}" ]; then
  : # 연산자가 실행 파일 경로를 제공함
elif command -v argus >/dev/null 2>&1; then
  ARGUS_BIN="$(command -v argus)"
elif [ -n "${ARGUS_INSTALL:-}" ]; then
  ARGUS_BIN="$ARGUS_INSTALL/.venv/bin/argus"
else
  echo "Set ARGUS_BIN or ARGUS_INSTALL" >&2; exit 2
fi

네이티브 PowerShell:

if ($env:ARGUS_BIN) {
  $ArgusBin = $env:ARGUS_BIN
} elseif (Get-Command argus -ErrorAction SilentlyContinue) {
  $ArgusBin = (Get-Command argus).Source
} elseif ($env:ARGUS_INSTALL) {
  $ArgusBin = Join-Path $env:ARGUS_INSTALL ".venv\Scripts\argus.exe"
} else {
  throw "Set ARGUS_BIN or ARGUS_INSTALL"
}

아래 명령 예제는 POSIX "$ARGUS_BIN" ... 구문을 사용합니다. PowerShell에서는 확인된 경로를 & $ArgusBin ...으로 호출하십시오.

소스 체크아웃의 경우 ARGUS_INSTALL="$HOME/src/Argus"는 예시일 뿐이며, 휴대 가능한 기본값이 아닙니다. 확인된 절대 실행 파일 경로를 기록하십시오. 절대로 다운로드, 재설치, Argus의 내부 모델/제공자 구성을 변경하거나 조용히 권한을 확장하지 마십시오.

핵심 운영 절차

  1. 소유한 작업 디렉토리 하나와 실제 보안 경계를 선택하십시오. Argus 프로젝트당 전용 절대 디렉토리를 사용하십시오. 다른 활성 Argus 프로젝트의 디렉토리 계층과 절대 겹치지 마십시오. 데몬이 활성화된 동안 디렉토리를 이동, 삭제 또는 공유 쓰기하지 마십시오. 진정한 병렬 작업은 별도의 프로젝트를 사용합니다. 작업 디렉토리는 소유권 경계이지 샌드박스가 아닙니다. ARGUS_SKILL_SAFE_MODE=1은 보호 장치를 추가하지만 모든 백엔드에 대한 격리 자체는 아닙니다. 민감한 입력을 준비하기 전에 선택한 백엔드에 대해 검증된 샌드박싱을 요구하거나 적절히 격리된 OS/컨테이너 경계 내에서 Argus를 실행하십시오. 기본 무인 모드는 내부 에이전트가 작업 디렉토리 이상에 액세스할 수 있도록 허용할 수 있습니다.
  2. 제한된 입력을 준비하십시오. 작업 관련, 공개 안전 입력만 inputs/ 아래에 복사하십시오. 결과, 비목표, 출력 경로, 수용 검사, 권한 제한, 검토/인용 요구 사항과 함께 OBJECTIVE.md를 작성하십시오. 대화 기록, 자격 증명 또는 관련 없는 개인 데이터를 준비하지 마십시오.
  3. 정확한 작업 디렉토리에서 사전 점검을 수행하십시오. "$ARGUS_BIN" doctor를 실행한 다음 "$ARGUS_BIN" --status를 프로브하십시오. 백엔드 인증을 확인해야 하는 경우에만 doctor --deep을 사용하십시오. 모든 일상적인 사전 점검에 해당 네트워크/인증 지연 시간을 추가하지 마십시오. Deep Doctor는 라이브 인증의 보편적인 증거가 아닙니다: 확인되지 않은 토큰, 오프라인 기능 또는 연결할 수 없는 경로를 보고하는 경우 해당 백엔드의 문서화된 비변경 라이브 준비 상태 프로브를 사용하여 디스패치 전에 확인하십시오. 필요한 검사가 통과되고, 의도된 프로젝트/작업 디렉토리가 식별되고, 소유권 충돌이 없으며, 운영상 필요한 내부 모델/제공자 선택이 설치 및 인증된 경우에만 계속하십시오. 외부 연산자는 여기에서 권한이 있을 때 해당 Argus 구성을 선택하거나 확인할 수 있지만 다른 운영 주체로 취급해서는 안 됩니다. 현재 Argus 최상위 도움말은 의도적으로 간결하며 지원되는 자동화 플래그를 생략할 수 있습니다. 다른 빌드에 대해 --notify, 데몬, bounded 또는 API 표면을 사용하기 전에 해당 빌드의 문서/파서 또는 안전한 프로브에서 확인하십시오. references/argus-runtime-surfaces.md를 참조하십시오.
  4. 내부 실행 구성을 필요한 경우에만 명시적으로 유지하십시오. 이미 구성되고 설치되었으며 인증된 Argus의 내부 모델/제공자를 선호하십시오. Argus가 요구하는 경우 제공자 이름을 한정하십시오. 준비 상태 확인 실패 후 구성 변경을 자동으로 수행하지 마십시오. 먼저 진단하고 위임된 권한을 초과하는 변경에 대해 승인을 받으십시오.
  5. 독립형 임무 하나를 디스패치하십시오. 작업 디렉토리에서 Argus에 준비된 입력 및 출력을 명명하는 자체 포함된 목표를 제공하십시오. 검사 → 실행 → 검증 → 수리 → 최종 아티팩트 종료를 요청하십시오. Argus의 네이티브 위험/수직 검토 정책을 따르십시오. 작업 계약 또는 실질적인 위험이 필요한 경우에만 명시적으로 독립적 검토를 요구하십시오. 임무당 하나의 제한된 결과물을 유지하십시오. 재사용 가능한 학습이 요청되지 않고 배포 정책이 허용하는 일회성 제한된 임무의 경우 ARGUS_SKILL_REQUIRE_POST_TASK_LEARNING=0을 설정하여 기본 사후 작업 학습 모델 호출을 피하십시오. 그렇지 않으면 구성된 학습 정책을 유지하십시오. 가능한 경우 대화형 조종석을 사용하십시오. 분리 실행의 경우 즉석 셸 루프 대신 Argus의 문서화된 데몬/bounded 표면을 사용하십시오.
  6. Argus 내부의 증거 경계를 유지하십시오. Argus는 내부적으로 계획, 엔지니어링 및 검토를 분리할 수 있습니다. 증거와 함께 결정 크기의 임무 및 아티팩트 변경을 요구하십시오. Argus의 정책이 독립적 검토를 요구하는 경우 실제 아티팩트, 제한, 인용 및 완료를 검사해야 합니다. 이는 외부 운영 모델의 추가 주체가 아닌 내부 책임입니다. 주장당 한 번의 결정적 검사를 선호하십시오. 의례적인 중복 증거나 추가 모델 턴은 피하십시오.
  7. 가장 강력한 호스트 기능을 사용하여 모니터링하십시오. references/adapters/에서 선택한 어댑터를 따르십시오. 호스트 백그라운드/프로세스 API는 관찰을 개선하지만 진실의 원천은 아닙니다: Argus의 내구성 있는 프로젝트 상태가 진실의 원천입니다. 활성 환경이 호스트 프로세스를 유지하는 경우에만 Argus의 분리된 데몬을 사용하십시오. 그렇지 않으면 정확한 작업 디렉토리/프로젝트 ID를 저장하고 이후 턴에서 해당 상태에 대해 Argus를 다시 시작하십시오. 분리 실행이 허용되지 않는 경우 포그라운드 조종석을 유지하거나 사용자에게 실행을 계속하도록 요청하십시오. 무인 모니터링을 주장하지 마십시오.
  8. 모든 경계에서 보류 질문 루프를 실행하십시오. 디스패치 시, 각 의미 있는 상태 확인 시, 차단/일시 중지/재계획 결과 후, 실행을 무인으로 두기 전, 응답 후, 종료 전에 "$ARGUS_BIN" --status를 검사하십시오. waiting on you : N unanswered question(s)는 중지 신호입니다. 가능한 경우 조종석/웹 UI Needs you 프롬프트도 검사하십시오. 검증된 Argus 0.1.1 빌드에서 API 지원 연산자는 GET /api/projects/{sid}/status 또는 GET /api/projects/{sid}/snapshot?compact=true를 검사할 수 있습니다. 둘 다 pending_questions를 노출하는 반면, 전체 스냅샷은 backlog의 행을 노출합니다. 이러한 읽기 경로는 ARGUS_SKILL_WEB_TOKEN이 구성된 경우에도 인증되지 않은 상태로 유지될 수 있습니다: 루프백 전용으로 유지하거나 신뢰할 수 있는 VPN/인증 역방향 프록시 뒤에 두십시오. 신뢰할 수 없는 네트워크에 직접 노출하지 마십시오. 다른 빌드에서는 이러한 경로를 기능 감지하십시오. 진행 상황 설명만으로는 충분하지 않습니다.
  9. 각 질문을 분류하십시오. 내구성 있는 미해결 마커는 비어 있지 않은 pending_question이 있는 백로그 행입니다. 유형이 지정된 카드에는 operator_decision.status == "pending", id, question, reason, evidence 및 선택적 options도 있습니다. 이는 정보 제공용 채팅 질문, 목표 텍스트, 검토 산문 또는 일반 /ask가 아닙니다. failed, paused_operator 또는 성공처럼 보이는 텍스트 옆에 있는 경우에도 내구성 있는 마커를 차단으로 취급하십시오. 표면화된 질문이 명확하게 위임된 권한 내에 있지 않는 한 Argus가 가역적인 기술 라우팅을 유지하도록 하십시오. 자격 증명/비밀, 지출, 삭제/강제 푸시/공개/외부 전송, 되돌릴 수 없거나 외부 지향적인 작업, 보안/신뢰 경계 변경, 법적/라이선스 결정, 중요한 범위/수용 변경 및 모호한 고영향 선택을 에스컬레이션하십시오.
  10. 권위 있는 표면을 통해 응답하십시오. 터미널/웹 조종석의 항목별 Needs you 카드를 선호하십시오. 검증된 Argus 0.1.1 빌드에서 API 클라이언트는 POST /api/projects/{sid}/decisions/{decision_id}/resolve와 {"option_id":"…","note":"…"} 또는 레거시 POST /api/projects/{sid}/backlog/{item_id}/answer와 {"text":"…"}를 사용할 수 있습니다. 일반 조종석 응답 또는 POST /api/projects/{sid}/message는 정확히 하나의 질문이 보류 중인 경우에만 Manager에 의해 라우팅됩니다. 여러 개가 있는 경우 특정 카드/항목을 처리하십시오. "$ARGUS_BIN" --notify '<answer>'는 지침을 대기열에 추가하며 정확히 하나의 질문이 보류 중인 경우에만 Manager가 바인딩할 수 있습니다. 대기열 확인은 해결이 아닙니다. 다른 빌드에서는 비조종석 경로를 기능 감지하십시오. 사용자를 대신하여 추측하지 마십시오.
  11. 기록을 확인한 다음 재개하십시오. 검증된 빌드에서 표면이 반환하는 경우 resolved: true를 요구하십시오. 이전 pending_question이 지워지고 해결이 기록되었는지 확인하십시오. 유형이 지정된 결정 카드가 있는 경우 해당 카드도 resolved가 되도록 요구하십시오. 레거시 유형 없는 질문에는 카드나 resolution_id가 없을 수 있습니다. 검사 시점에 여전히 활성화되어 있어야 하는 것이 아니라 실제 보류, 실행 중, 완료 또는 중지된 상태에서 연속을 관찰하십시오. stop 결정은 대신 항목을 중단하고, 작업을 보존하며, 연속 모드를 비활성화하고, 연속을 생성하지 않습니다. 상태를 다시 실행하고 의도한 대로 실행이 재개, 완료 또는 중지되었는지 확인하십시오. 마커가 남아 있으면 명확히 하거나 에스컬레이션하십시오. 중복 추측을 보내지 마십시오.
  12. 궤적을 가져오지 않고 검사하십시오. 현재 임무, 역할, 단계, 백로그, 결과, 최신 확인된 위치 및 Needs you에 대해 상태/조종석을 사용하십시오. 백로그와 최신 확인된 증거를 프론티어로 취급하십시오. 원시 대화록, 데몬 로그, 에이전트 I/O, 사용 로그 및 개인 원장을 로컬에 유지하십시오.
  13. 아티팩트를 검색하고 검증하십시오. 명명된 출력 경로를 읽으십시오. 존재, 요청된 범위 및 결정적인 테스트를 확인하십시오. 모든 실질적인 인용을 준비된 소스로 확인하십시오. 가짜, 오래된 현재 또는 주장 불일치 인용을 거부하십시오. 진행 메시지에서 성공을 절대 추론하지 마십시오.
  14. 내구성 있는 상태에서 복구하십시오. 일시 중지된 쓰기/실행 작업을 인라인 채팅 응답이 아닌 자체 포함된 재개 목표로 내구성 있는 상태에서 재개하도록 Argus에 요청하여 다시 시작하십시오. 내부 실행 스레드를 재개할 수 없는 경우 Argus 체크포인트/캡슐을 사용하십시오. Argus 구성 또는 목표를 변경하기 전에 해결되지 않은 질문, 소유권, 내부 모델/제공자 준비 상태, 예산/쿨다운 및 인프라를 진단하십시오.
  15. 증거에 대해서만 종료하십시오. 제한된 목표가 충족되고, 아티팩트 및 결정적인 검사가 통과되고, 필수 검토자 평결이 done이며, 보류 중인 질문/카드가 없는 경우 완료하십시오. continue, replan_requested, blocked, 연구-일시 중지 또는 응답되지 않은 Needs you는 완료가 아닙니다. 임무 완료와 프로젝트/단계 완료를 구별하십시오. references/closeout-checklist.md를 사용하십시오.

기능 대체 방안

  • 네이티브 스킬 검색 없음: 전체 번들을 제공하거나 호스트에 이 파일과 일치하는 어댑터를 읽도록 명시적으로 지시하십시오. 자동 활성화를 주장하지 마십시오.
  • 셸 없음: 호스트가 로컬 Argus를 직접 작동할 수 없습니다. 승인된 원격 셸/터미널 통합을 사용하거나 정확한 연산자 단계를 전달하십시오. 실행을 시뮬레이션하지 말고 차단으로 표시하십시오.
  • 셸 있지만 프로세스 API 없음: 환경이 프로세스를 유지하는 경우에만 Argus --daemon을 선호하십시오. 항상 프로젝트/작업 디렉토리 ID를 유지하고 상태/조종석으로 다시 진입하십시오. 호스트의 문서화된 환경이 유일한 승인된 경로로 만드는 경우가 아니면 취약한 &, nohup 또는 sleep/폴 루프로 백그라운드 실행하지 마십시오.
  • 프로세스 API 있지만 호스트 세션 간에 내구성 없음: 라이브 로그에만 사용하십시오. 내구성 있는 Argus 프로젝트 상태가 복구 앵커로 남아 있으며 데몬을 다시 시작해야 할 수 있습니다.
  • HTTP/API 클라이언트 없음: 터미널/웹 조종석 및 --status를 사용하십시오. 질문 루프에 API 액세스를 절대 요구하지 마십시오.
  • 대화형 승인 경로 없음: 승인 게이트 작업에 대해 닫힘 실패하십시오. 안전한 사전 점검을 변경 작업 실행에서 분리하거나 인간이 해당 호스트의 지원 UI를 통해 승인하도록 요청하십시오. 단순히 무인 실행을 위해 승인/샌드박스 플래그를 우회하지 마십시오.
  • 무인 실행 허용되지 않음: 대화형 세션을 열어 두거나 정확한 재개 지침과 해결되지 않은 상태로 중지하십시오. 모니터링을 조건부로 보고하고 활성으로 보고하지 마십시오.

프라이버시, 권한 및 반환

최소 데이터를 준비하십시오. 사용자가 보호된 원격 액세스를 승인하지 않는 한 웹 UI를 루프백 전용으로 유지하십시오. 현재 사용자 지침 및 새로운 증거는 이전 계획이나 런타임 제안을 재정의합니다.

호출 표면에만 반환하십시오: 작업 디렉토리/프로젝트 ID, 간결한 결과/프론티어, 검토자 평결, 아티팩트 경로, 결정적인 검증, 인용 예외...

관련 스킬