CatPope

agent-operations

서브에이전트·로그 모니터 에이전트를 새로 배정하거나 운영 규칙을 정할 때 사용. 역할·권한·영속 근거를 관련 업무 스킬에 함께 반영해 세션 압축 후에도 운영을 복구한다.

CatPope 0 Updated 1mo ago
GitHub

Install

npx skillscat add catpope/agent-harness/agent-operations

Install via the SkillsCat registry.

SKILL.md

서브에이전트 운영 기록

서브에이전트는 세션 안에서만 동작하는 실행 주체다. 역할을 새로 만들거나, 모델·권한·모니터링 방식 같은
반복 운영 규칙을 정하면 해당 업무의 기존 스킬을 같은 작업에서 갱신해 다음 세션에서도 적용되게 한다.

적용 시점

  • 사용자 요청으로 서브에이전트를 생성·배정할 때
  • 장기 실행의 정보 수집·로그 모니터·검증·코드 작업처럼 반복되는 에이전트 역할을 정할 때
  • 에이전트의 모델, 수정 권한, 보고 형식, 재개 방식이 바뀔 때

기록 원칙

  1. 먼저 어떤 업무 스킬이 그 에이전트 운영의 정본인지 정한다 — 그 에이전트가 하는 일의 스킬이다.
    예: 결과 기록을 맡겼다면 [[result-record]], 프로젝트에 재현·실행 절차 스킬이 있다면 그쪽.
  2. 새 역할이 반복 운영 규칙이면, 에이전트를 생성한 같은 작업에서 정본 스킬에 다음을 짧게 기록한다.
    역할·사용 모델·읽기/쓰기 권한·보고해야 할 근거·세션 종료 후 복구 방법.
  3. 일회성 탐색처럼 재사용 가치가 없는 배정은 스킬에 누적하지 않는다. 대신 결과와 근거 경로만 작업 로그에 남긴다.
  4. 기존 스킬에 맞는 위치가 없을 때만 이 스킬을 정본으로 보완한다. 업무 스킬의 구체 규칙을 이 파일로 중복하지 않는다.

영속성과 모니터링

  • /compact, 세션 종료, 에이전트 종료 뒤에는 서브에이전트가 상주하지 않는다. 완료 여부나 진행 상태를
    에이전트의 대화 기억에만 의존하지 않는다.
  • 장기 실행은 프로젝트 폴더에 로그와 모델·단계별 산출물을 남긴다. 다음 세션에서 새 에이전트를 배정해
    로그·프로세스·결과 파일로 상태와 재개 지점을 복구한다.
  • 로그 모니터 에이전트의 기본 권한은 읽기 전용이다. 코드·문서·데이터·실행 프로세스 변경은 사용자가
    명시적으로 허가한 별도 역할에서만 수행한다.

현재 확정된 적용 사례

  • 장기 실행되는 학습·평가·배치 작업: 저비용 모델을 읽기 전용 모니터로 배정한다.
    보고 항목과 로그 경로 규칙은 그 작업의 정본 스킬을 따른다(예: [[result-record]] 의
    로그·산출 규칙). 이 스킬에 규칙을 복제하지 않는다.

이력 (필수 기록)

  • 생성일: 2026-08-20
  • 업데이트 횟수: 1
  • 최근 업데이트: 2026-08-27
  • 사용 이력:
    • 2026-08-20 — 신규 생성. 서브에이전트 생성 시 반복 운영 규칙을 관련 업무 스킬에도
      반드시 반영하도록 사용자가 요청.
    • 2026-08-27 — 공용 저장소로 이관하며 정본 스킬 지칭을 역할 서술로 바꿨다.
      이 저장소에 없는 스킬 2개를 이름으로 가리키고 있었는데, 포터빌리티 린터는
      구조만 검사하므로 전부 통과한 상태에서도 남아 있었다.

Categories