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