에이전트 전사(Agent Transcript)
사용자가 명시적으로 전사 또는 미리보기를 요청할 때만 사용합니다. 기본적으로 생략하며, 일반 PR 작업 중에는 제공하거나 포함 여부를 묻지 마세요. 미리보기 요청만으로는 게시가 허가되지 않습니다.
로컬 준비
이 헬퍼는 로컬 Codex, Claude, Pi 및 OpenClaw 로그를 읽습니다. 검색 및 렌더링에 네트워크를 사용하지 않습니다. 원시 로그를 절대 업로드하지 마세요.
.agents/skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
.agents/skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" --out /tmp/agent-transcript.md
find는 기본적으로 가장 최근의 일치하는 로그 400개를 검색합니다. --max-files N으로 로컬 검색 범위를 넓힐 수 있습니다. 일치 항목을 증거가 아닌 후보로 취급하세요.
렌더링된 마크다운을 표시, 미리보기, 삽입하기 전에 자동으로 다듬습니다. 작업 관련 사용자 프롬프트, 가시적 결정, 간결한 도구 요약, 증명 결과만 유지하세요. PR/이슈 목표, 브랜치 및 변경된 파일을 사용하여 관련 없는 앞/뒤 턴을 제거하세요. 시스템/개발자 프롬프트, 추론, 원시 도구 출력, 환경 데이터, 로컬 경로, 자격 증명, 브라우저/세션/쿠키 세부 정보, 인증 URL을 삭제하세요. 다듬어진 결과를 검사하세요. 헬퍼의 정리(redaction)만으로는 공개 검토가 충분하지 않습니다. 해결되지 않은 민감한 콘텐츠가 있으면 전사 기록을 생략하세요.
미리보기 및 삽입
요청된 미리보기에 대해 다듬어진 마크다운을 보여줍니다. HTML이 요청된 경우, 해당 다듬어진 내용으로 로컬 미리보기를 빌드하세요. 헬퍼의 preview, html, append-body 모드는 세션을 다시 렌더링합니다. 이 모드들은 편집된 마크다운 파일을 사용하지 않으며 제거된 턴을 다시 도입할 수 있습니다. 다듬어지지 않은 출력을 승인된 아티팩트로 사용하지 마세요.
사용자의 승인이 특정 PR/이슈에 해당 전사 기록을 게시하는 것을 명시적으로 포함하는 경우에만 검사되고 범위가 정해진 텍스트를 삽입하세요. 전사 기록을 생성하거나 미리보기하는 것은 게시를 허가하지 않습니다. 일반적인 PR 생성 또는 편집이 이미 승인된 경우에도 마찬가지입니다. 해당 범위가 없으면, 다듬어진 결과를 보여주고 삽입 전에 게시 승인을 받으세요. 전사 기록 게시를 포함하는 기존의 명시적 승인은 재확인이 필요 없습니다. 접힌 <details> 섹션을 유지하고 기존 전사 기록 마커를 복제하지 말고 교체하세요. 안전한 일치 항목이 없으면 전사 기록이나 플레이스홀더 없이 PR 작업을 계속하고, 명시적으로 요청된 전사 기록을 방해하는 경우 그 생략을 설명하세요. 전사 기록 포함을 검토 우선 요구 사항으로 홍보하지 마세요.