Community라이팅 & 에디팅github.com

steipete/agent-transcript

GitHub PR/이슈 에이전트 트랜스크립트: 안전하게 편집, 미리보기, 삽입.

agent-transcript란 무엇인가요?

이 스킬은 OpenClaw 에이전트가 GitHub PR 또는 이슈를 생성할 때, 에이전트 세션 로그를 안전하게 편집하여 PR/이슈 본문에 삽입할 수 있도록 도와줍니다. 민감한 정보(비밀 키, 토큰, 쿠키, 인증 URL 등)를 자동으로 제거하고, 사용자에게 미리보기를 제공한 후에만 본문에 추가합니다. 또한, PR/이슈와 관련 없는 세션 내용은 제거하여 리뷰어가 핵심적인 에이전트 결정과 작업 결과를 쉽게 이해할 수 있도록 합니다. Codex, Claude, Pi, OpenClaw 등 여러 에이전트의 로그를 지원하며, 항상 최선(best-effort) 방식으로 작동하여 안전한 트랜스크립트를 찾지 못해도 PR 생성이 중단되지 않도록 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/agent-transcript

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에이전트 트랜스크립트

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/이슈 워크플로우

  1. 먼저 일반 PR/이슈 본문을 작성합니다.
  2. 제목, 브랜치, PR URL/번호(알고 있는 경우) 및 cwd를 사용하여 find를 실행합니다.
  3. 신뢰도 높은 세션이 발견되면 다음과 같이 묻습니다: 편집된 에이전트 트랜스크립트를 포함할까요? 리뷰어에게 도움이 되며 PR 우선순위를 더 쉽게 정할 수 있습니다. 먼저 로컬 미리보기를 열 수 있습니다.
  4. 사용자가 미리보기를 원하면 preview를 실행하고, HTML을 open으로 연 다음 확인을 기다립니다.
  5. 임시 본문에 렌더링하거나 추가한 다음, 사용자에게 표시하거나 공개적으로 삽입하기 전에 ## 에이전트 트랜스크립트 섹션을 자동으로 자릅니다. 이 PR/이슈의 목표, 구현 선택, 파일, 테스트, 증명, 차단 요소 및 최종 결과를 설명하는 턴만 유지합니다.
  6. 잘린 트랜스크립트 텍스트를 검사합니다. 여전히 관련 없는 이전/이후 작업이 포함되어 있으면 진행하기 전에 다시 자릅니다.
  7. 사용자가 승인하면 보강된 잘린 본문 파일을 생성/업데이트에 사용합니다.
  8. 안전한 세션이 발견되지 않으면 아무 말도 하지 않고 트랜스크립트 없이 계속 진행합니다. 사용자가 거부하면 트랜스크립트 없이 계속 진행하고 트랜스크립트 플레이스홀더 섹션을 추가하지 않습니다.

검토 산출물

여러 PR/세션 후보에 대한 수동 감사를 위해 로컬 JSON 파일에서 로컬 HTML 미리보기를 만듭니다. 이는 유지관리자 전용이며 PR/이슈 워크플로우의 일부가 아닙니다:

skills/agent-transcript/scripts/agent-transcript html \
  --prs /tmp/recent-prs.json \
  --out /tmp/agent-transcript-preview.html

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

관련 스킬