에이전트 트랜스크립트
OpenClaw PR/이슈 본문을 위한 최선의 로컬 전용 출처 증명입니다. 에이전트가 생성한 GitHub PR 또는 이슈 워크플로우에서 본문을 생성/업데이트하기 전에 사용합니다.
규약
- 네트워크를 절대 사용하지 마십시오. 세션 검색은 로컬 에이전트 로그만 읽습니다.
- 원시 로그를 절대 업로드하지 마십시오. 먼저 정리된 마크다운으로 렌더링하십시오.
- GitHub PR/이슈 본문에 트랜스크립트 로그를 추가하기 전에 항상 사용자에게 물어보십시오.
- 정리된 세션 로그가 리뷰어에게 도움이 되며 PR의 우선순위를 더 쉽게 정할 수 있다고 사용자에게 알리십시오.
- 삽입 전에 로컬 HTML 미리보기를 제공하십시오. 사용자가 미리보기를 원하면 열고 섹션을 추가하기 전에 확인을 기다리십시오.
- 해결되지 않은 비밀, 개인 키, 브라우저/세션/쿠키 세부 정보, 인증 URL에 대해서는 오류와 함께 중단하십시오.
- 시스템/개발자 프롬프트, 원시 도구 출력, 추론, 환경 변수, 쿠키, 토큰 및 광범위한 로컬 경로를 제거하십시오.
- 사용자 프롬프트, 어시스턴트의 명시적 결정, 간결한 도구 요약, 테스트/증명 결과는 유지하십시오.
- 렌더링된 트랜스크립트를 표시, 미리보기 또는 공개 본문에 삽입하기 전에 자동으로 자르십시오.
render또는append-body가 생성했다고 해서 전체 세션 렌더링을 PR/이슈 본문에 절대 붙여넣지 마십시오. - PR/이슈 작업과 관련 없는 세션 턴을 제거하십시오. PR/이슈 제목, 브랜치 이름, 변경된 파일 및 명시된 목표를 범위로 사용하고, 같은 세션 로그에 있더라도 이전/이후의 관련 없는 작업은 생략하십시오.
- 최선의 노력만 수행하십시오: 안전한 트랜스크립트를 찾을 수 없으면 PR/이슈 생성을 계속해야 합니다.
- 실제 트랜스크립트를 삽입할 때만
## 에이전트 트랜스크립트섹션을 추가하십시오. "정리된 로컬 트랜스크립트 미리보기가 생성되었으나 포함되지 않았습니다."와 같은 플레이스홀더 트랜스크립트 제목이나 텍스트를 절대 추가하지 마십시오. - 접힌
<details>섹션을 사용하고 섹션을 중복하는 대신 기존 마커를 업데이트하십시오.
도우미
skills/agent-transcript/scripts/agent-transcript --help
가능성 있는 로컬 세션 찾기:
skills/agent-transcript/scripts/agent-transcript find \
--query "$PR_TITLE $BRANCH_OR_PR_URL" \
--cwd "$PWD" \
--since-days 14
find는 기본적으로 Codex, Claude, Pi 및 OpenClaw 에이전트 세션에서 가장 최근 일치하는 400개의 로컬 JSONL 로그를 스캔합니다. 더 넓은 로컬 검색을 위해 --max-files N을 사용하십시오.
.agents/skills 아래에 공유 스킬을 동기화하는 다운스트림 저장소에서는 skills/agent-transcript를 .agents/skills/agent-transcript로 바꾸십시오.
PR/이슈 본문 섹션 렌더링:
skills/agent-transcript/scripts/agent-transcript render \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript.md
하나의 후보 세션을 로컬에서 미리보기:
skills/agent-transcript/scripts/agent-transcript preview \
--session "$SESSION_JSONL" \
--out /tmp/agent-transcript-preview.html
open /tmp/agent-transcript-preview.html
gh pr create --body-file 또는 커넥터 PR 생성 전에 본문 파일에 추가/업데이트:
skills/agent-transcript/scripts/agent-transcript append-body \
--body /tmp/pr-body.md \
--session "$SESSION_JSONL" \
--out /tmp/pr-body.with-transcript.md
PR/이슈 워크플로우
- 먼저 일반 PR/이슈 본문을 작성합니다.
- 제목, 브랜치, PR URL/번호(알고 있는 경우) 및 cwd를 사용하여
find를 실행합니다. - 신뢰도 높은 세션이 발견되면 다음과 같이 묻습니다:
편집된 에이전트 트랜스크립트를 포함할까요? 리뷰어에게 도움이 되며 PR 우선순위를 더 쉽게 정할 수 있습니다. 먼저 로컬 미리보기를 열 수 있습니다. - 사용자가 미리보기를 원하면
preview를 실행하고, HTML을open으로 연 다음 확인을 기다립니다. - 임시 본문에 렌더링하거나 추가한 다음, 사용자에게 표시하거나 공개적으로 삽입하기 전에
## 에이전트 트랜스크립트섹션을 자동으로 자릅니다. 이 PR/이슈의 목표, 구현 선택, 파일, 테스트, 증명, 차단 요소 및 최종 결과를 설명하는 턴만 유지합니다. - 잘린 트랜스크립트 텍스트를 검사합니다. 여전히 관련 없는 이전/이후 작업이 포함되어 있으면 진행하기 전에 다시 자릅니다.
- 사용자가 승인하면 보강된 잘린 본문 파일을 생성/업데이트에 사용합니다.
- 안전한 세션이 발견되지 않으면 아무 말도 하지 않고 트랜스크립트 없이 계속 진행합니다. 사용자가 거부하면 트랜스크립트 없이 계속 진행하고 트랜스크립트 플레이스홀더 섹션을 추가하지 않습니다.
검토 산출물
여러 PR/세션 후보에 대한 수동 감사를 위해 로컬 JSON 파일에서 로컬 HTML 미리보기를 만듭니다. 이는 유지관리자 전용이며 PR/이슈 워크플로우의 일부가 아닙니다:
skills/agent-transcript/scripts/agent-transcript html \
--prs /tmp/recent-prs.json \
--out /tmp/agent-transcript-preview.html