Communityライティング&編集github.com

steipete/agent-transcript

GitHub PR/Issueへのエージェントトランスクリプト:安全に編集、プレビュー、挿入。

agent-transcript とは?

このスキルは、OpenClawエージェントが作成したGitHub PRやIssueの本文に、エージェントのセッションログを安全に挿入するためのものです。機密情報(シークレット、トークン、認証URLなど)を自動的に除去・編集し、レビュアーがPRの背景や実施内容を理解しやすくするサマリーを提供します。対応プラットフォームはCodex、Claude、Pi、OpenClawのエージェントセッションです。このスキルは、まずローカルのJSONLログから該当するセッションを検索し、ユーザーの承認を得た上で、編集済みのトランスクリプトをマークダウン形式でPR本文に追加します。プレビュー機能を使って、実際に挿入する前に内容を確認でき、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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Agent Transcript

OpenClawのPR/Issue本文に対する、ローカルのみで動作するベストエフォートな来歴機能。エージェント生成のGitHub PRやIssueワークフローで、本文を作成・更新する前に使用します。

契約

  • 決してネットワークを使用しない。セッション検出はローカルのエージェントログのみを読み取ります。
  • 生のログをアップロードしない。サニタイズしたMarkdownを先にレンダリングしてください。
  • GitHub PR/Issue本文にトランスクリプトログを追加する前に、必ずユーザーに確認をとってください。
  • サニタイズされたセッションログはレビュアーの助けになり、PRの優先順位付けを容易にすることをユーザーに伝えてください。
  • 挿入前にローカルのHTMLプレビューを提供してください。ユーザーがプレビューを希望する場合は開き、セクションを追加する前に確認を待ってください。
  • 解決されていないシークレット、秘密鍵、ブラウザ/セッション/クッキーの詳細、認証URLが含まれている場合は、安全側に倒して失敗してください。
  • システム/開発者プロンプト、生のツール出力、推論、環境、クッキー、トークン、広範なローカルパスは削除してください。
  • ユーザープロンプト、アシスタントの目に見える判断、簡潔なツールサマリー、テスト/証明の結果は保持してください。
  • レンダリングしたトランスクリプトは、表示、プレビュー、パブリックボディへの挿入の前に、自動的にトリミングしてください。render や append-body が生成したからといって、完全なセッションの生のレンダリングをPR/Issue本文に貼り付けないでください。
  • PR/Issueの作業に関係のないセッションターンは削除してください。スコープとしてPR/Issueのタイトル、ブランチ名、変更ファイル、および表明された目標を使用し、同じセッションログ内にあっても、関連のない前後のタスクは省略してください。
  • ベストエフォートのみ:安全なトランスクリプトが見つからない場合でも、PR/Issue作成は続行する必要があります。
  • 実際のトランスクリプトを挿入する場合のみ、## Agent Transcript セクションを追加してください。「サニタイズされたローカルトランスクリプトのプレビューが生成されましたが、含まれていません。」のようなプレースホルダーのトランスクリプト見出しやテキストを決して追加しないでください。
  • 折りたたみ可能な <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/Issue本文セクションをレンダリングする:

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/Issue ワークフロー

  1. まず通常のPR/Issue本文をドラフトします。
  2. タイトル、ブランチ、既知のPR URL/番号、cwdを指定して find を実行します。
  3. 信頼性の高いセッションが見つかった場合、確認を求めます: 編集済みのエージェントトランスクリプトを含めますか?レビュアーの助けになり、PRの優先順位付けを容易にします。まずローカルプレビューを開くことができます。
  4. ユーザーがプレビューを希望する場合は、preview を実行し、HTMLを open で開き、確認を待ちます。
  5. 一時的な本文にレンダリングまたは追加し、ユーザーに表示したり公開前に挿入する前に、## Agent Transcript セクションを自動的にトリミングします。このPR/Issueの目標、実装の選択、ファイル、テスト、証明、ブロッカー、および最終結果を説明するターンのみを保持します。
  6. トリミングされたトランスクリプトテキストを検査します。それでも関連のない前後の作業が含まれている場合は、続行する前にもう一度トリミングします。
  7. ユーザーが承認した場合、充実したトリミング済み本文ファイルを作成/更新に使用します。
  8. 安全なセッションが見つからない場合は、何も言わずにトランスクリプトなしで続行します。ユーザーが拒否した場合は、トランスクリプトなしで続行し、トランスクリプトのプレースホルダーセクションを追加しないでください。

レビュー用アーティファクト

複数のPR/セッション候補にわたる手動監査のために、ローカルJSONファイルからローカルHTMLプレビューを作成します。これはメンテナのみを対象としており、PR/Issueワークフローの一部ではありません:

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.

関連スキル