pagent은(는) 무엇을 하나요?
개요
Paseo 에이전트를 찾아 대화 내용을 읽습니다. 매번 Paseo 파일 위치를 다시 찾을 필요가 없습니다. pagent는 읽기만 수행합니다. 에이전트를 시작, 중지, 제어 또는 재생성하지 않으며, 종료된 에이전트를 다시 로드하도록 데몬에 요청하지 않습니다.
호출
SKILL=<이 스킬의 기본 디렉터리>/pagent.py # harness가 위에 기본 디렉터리를 출력합니다
python3 $SKILL 11111111-1111-4111-8111-111111111111 # 헤드: 상태, cwd, 모델, 트랜스크립트 경로
python3 $SKILL 11111111 --task # + 사용자가 준 모든 지시
python3 $SKILL 11111111 -t -n 20 # + 마지막 20턴
python3 $SKILL 11111111 -t --full # 턴을 자르지 않고 전체 출력
python3 $SKILL "invoice export" # 제목으로 검색
python3 $SKILL # 모든 에이전트, 최신순
쿼리는 ID, ID 접두사, 또는 제목의 대소문자를 구분하지 않는 부분 문자열입니다. 여러 개가 일치하면 목록으로 출력되고, 정확히 하나가 일치하면 상세 보기가 출력됩니다. python3 $SKILL --help를 실행하면 사용법이 출력됩니다.
단계
- 에이전트 식별. 플래그 없이 쿼리 실행: 헤드에 상태, 작업 디렉터리, 모델 및 트랜스크립트 경로가 표시됩니다. 목록으로 출력되면 쿼리가 모호하다는 의미이므로, ID나 더 긴 제목 조각으로 좁히십시오.
- 요청 내용 확인.
--task는 첫 번째 지시뿐만 아니라 사용자가 준 모든 지시를 출력합니다. 첫 줄은 주제를 명명하고, 두 메시지 후의 수정 사항은 결정 사항을 전달합니다("옵션 B를 사용하되 재시도 제한은 3으로 유지"). 둘 다 출력되며, harness 서문과 주입된 스킬 본문은 출력되지 않습니다. 이는 에이전트의 작업을 인계받을 때 가장 중요합니다.ptakeover스킬을 참조하십시오. - 진행 상황 확인.
-t -n <턴 수>는 대화의 끝 부분을 출력합니다. 턴이 잘린 경우--full을 추가하십시오. 트랜스크립트는 추가 전용이므로 에이전트가 실행 중일 때 읽어도 안전합니다. - 주변 확인.
cwd가 일치하는 에이전트는 동일한 파일을 편집하고 있을 수 있습니다. 예상치 못한 diff가 자신의 것이라고 가정하기 전에git status를 실행하십시오.
-t 또는 --task와 함께 사용할 때 트랜스크립트가 없으면 0이 아닌 종료 코드로 종료됩니다. 조용한 0은 "에이전트가 아무 말도 하지 않았다"는 의미로 읽히므로, 할당을 재구성하는 사람에게 잘못된 결론을 전달하게 됩니다.
데이터 저장 위치
- 에이전트 메타데이터:
~/.paseo/agents/<workspace>/<id>.json— 제목,lastStatus(running/idle/ …),cwd, 모델,requiresAttention, 타임스탬프. - 대화: 해당 파일에 없음. 대화는 작성한 harness에 있으며,
persistence.sessionId로 키가 지정됩니다:- Claude Code —
<config>/projects/<escaped-cwd>/<sessionId>.jsonl. claude-rotate는 계정별로 하나의 config 디렉터리를 유지하므로~/.claude또는~/.config/claude-rotate/configs/*/아래에 있을 수 있습니다. 스크립트는 이스케이프된 경로를 추측하는 대신 모든 디렉터리를 glob합니다. - Codex —
~/.codex/sessions/<y>/<m>/<d>/rollout-<stamp>-<sessionId>.jsonl, 다른 레코드 구조(payload.type)를 가지며 파서가 Claude의 것과 함께 처리합니다. 에이전트를 보관하면 rollout이 평면~/.codex/archived_sessions/로 이동합니다. - Antigravity —
sessionId는plugin:{…"conversationId":…}래퍼이며, 기록은~/.gemini/antigravity-cli/brain/<conversationId>/.system_generated/logs/transcript_full.jsonl에 있습니다(레코드는step_index로 키 지정).conversations/<id>.db가 아닙니다. 그 파일은 protobuf입니다. 이전antigravity-acp제공자의 에이전트는 해당 로그를 작성하지 않으므로 읽을 수 있는 기록이 없습니다.
- Claude Code —
에이전트와 대화하고 기다리기
이 스킬은 읽기만 수행합니다. 나머지는 다음을 참조하십시오:
- 대화:
paseo send <id> "<text>" --behavior steer --no-wait. 에이전트 범위의 CLI 및send_agent_prompt호출은 기본적으로 steering을 사용합니다. 명시적인 행동은 에이전트 외부에서도 작동합니다. Steering은 제공자가 수용할 수 없는 경우(예: 압축 중) 중단으로 대체될 수 있습니다.--no-wait는 전송 후 반환하며, 메시지를 턴 뒤에 대기시키지 않습니다. - 실수로 재생성하지 마십시오:
paseo send는 보관된 에이전트를 재생성하므로, 먼저paseo inspect <id> --json에서ArchivedAt을 확인하십시오. 보고서를 전달하기 위해 보관된 에이전트를 절대 재생성하지 마십시오. 대신 해당 작업(TODO, 프로토콜 또는 커밋)과 함께 정보를 남기거나 사용자에게 알리십시오. - 기다리기:
paseo-notify <id>를 실행한 후 턴을 종료하십시오. 에이전트가 중지되면 메시지 하나가 도착합니다. paseo 외부:paseo wait <id> --json을 백그라운드에서 실행하고, JSON에서status(idle,permission,error,timeout)를 읽으십시오. 종료 코드는 모두 0입니다.sleep, Monitor,/loop또는paseo ls/logs/inspect폴링으로 기다리지 마십시오.
일반적인 실수
| 실수 | 해결 방법 |
|---|---|
| 첫 요청만으로 작업 인계 | --task는 이후의 모든 수정 사항도 출력하며, 여기에는 결정 사항이 포함됩니다 |
종료되거나 보관된 에이전트를 읽기 위해 paseo logs 사용 | 데몬이 에이전트의 세션을 다시 로드하여 읽기만 하게 됩니다. 이 스킬을 사용하면 파일만 읽습니다 |
| 조용한 종료를 "에이전트가 아무 말도 하지 않았다"로 읽기 | 트랜스크립트가 없으면 0이 아닌 종료 코드로 종료됩니다. 종료 코드와 헤드의 트랜스크립트 경로를 확인하십시오 |
| 보관된 에이전트에 보고서 보내기 | paseo send는 에이전트를 재생성합니다. 먼저 ArchivedAt을 확인하고 대신 작업과 함께 보고서를 남기십시오 |
sleep, Monitor, /loop 또는 반복적인 paseo ls/logs/inspect로 에이전트 기다리기 | paseo-notify <id>를 실행하고 턴을 종료하십시오 |
에이전트가 cwd를 공유할 때 예상치 못한 diff를 자신의 것으로 간주 | git status 확인; 에이전트가 동일한 파일을 편집하고 있을 수 있습니다 |