agy staffer
범용 페르소나: 전문가가 적합하지 않은 작업을 처리하기 위한 깔끔한 진입점입니다. 프롬프트 템플릿은 의도적으로 최소화되어 있습니다 — 작업 텍스트, 환경(cwd, 브랜치, 날짜), 공유 작업 규칙, 안전 가드레일만 포함하며 그 외에는 아무것도 없습니다. 역할 프레이밍이나 고정된 본문 형식이 없으므로 작업이 자체 결과물을 정의하며, 도메인별 템플릿 컨텍스트가 실행을 흐트러뜨리지 않습니다.
해당하는 전문가가 있을 때는 그 쪽을 우선 사용하세요: researcher(조사 및 심층 분석), reviewer(코드/계획에 대한 검토), implementer(작업 트리 수정), ask(간단한 단발성 질문).
staffer는 또한 전문가가 다루지 않는 agy 네이티브 도구로 가는 경로입니다 — 특히 이미지 생성: agy에는 generate_image 도구가 내장되어 있습니다(v1.1.15에서 확인; 1024×1024 PNG 약 30초 소요). 작업에서 출력 경로를 명시하세요, 예: staffer --prompt "픽셀 아트 로봇 마스코트 생성, assets/mascot.png로 저장"
컴패니언 찾기
이 스킬 파일은 <plugin-root>/skills/staffer/SKILL.md에 위치합니다; 이 스킬 디렉토리를 기준으로 컴패니언 경로를 확인하세요:
node "<skill-dir>/../../companion/agy-companion.mjs" staffer [flags] --prompt "작업"
사용자의 작업 텍스트를 --prompt를 통해 그대로 전달하세요. 긴 텍스트는 --prompt-file <path> 또는 --stdin을 사용하세요.
[!IMPORTANT] 이 명령어는 샌드박스 없이 실행하세요 — agy가 로컬호스트 포트와 OAuth 토큰 파일이 필요하며, 샌드박스가 이를 숨깁니다. Codex에서는 명령어에 대해 상승된 권한을 요청하세요. 자세한 내용:
../jobs/references/troubleshooting.md.
결과 수집
명령어는 job ID를 반환합니다. 결과 수집 및 복구는 ../jobs/SKILL.md를 참조하세요: 전달, 최종 결과 대기, 필요한 경우 검증. 실행 중에는 진행 상황을 능동적으로 관찰하거나, 로그를 읽거나, 중간 산출물을 검사하지 마세요. 사용자가 명시적으로 진행 상황을 요청할 때만 관찰하며, 작업 프로토콜에 따라 실패 또는 개입이 필요한 결과에 대해 진단하세요.
플래그 (모두 선택 사항)
--prompt <text>/--prompt-file <path>/--stdin— 작업 내용, 세 가지 출처 중 정확히 하나만 사용하세요. 긴 프롬프트는 쉘 인용 대신 파일/stdin을 사용하세요.--model <id>또는--effort low|medium|high— 기본 모델은gemini-3.8-flash-medium입니다.--restricted/--unrestricted— 권한 프로필; staffer는 다른 도구 사용 페르소나처럼 기본적으로 unrestricted이며,--restricted는 강화 경로입니다.--continue(또는--conversation <id>),--timeout <dur>(기본 60분, 최대 120분 하드 실행 제한).
규칙
- 사용자의 작업을 그대로 전달하세요. 템플릿이 출력 형식을 강제하지 않으므로, 특정 형식이 필요한 경우 작업 텍스트에 명시하세요.
- 사용자의 명시적 권한 부여를 그대로 전달하세요. 템플릿은 기본적으로 비용이 많이 들거나 되돌릴 수 없는 부작용(커밋/푸시, 작업 공간 외부 파일 삭제, 부작용이 있는 네트워크 호출, 유료 할당량 명령어)을 거부하며, 작업 자체에서 해당 작업을 요청하는 경우에만 열립니다.
- 일반 작업은 파일을 적절히 수정할 수 있습니다. 컴패니언은 작업 트리의 변경 사항을 결과와 함께 보고합니다. 이를 검사(
git diff)하고, 그 결과를 기반으로 작업하기 전에 작업이 요청한 내용과 일치하는지 확인하세요. - 오류 및 복구는
../jobs/SKILL.md를 따르세요.
기존 대화의 경우, --continue / --conversation <id>는 명시적으로 재정의하지 않는 한 기록된 모델과 권한 프로필을 상속받습니다. 위의 unrestricted 기본값은 새 작업에 적용됩니다.