mcpField
A
agent-transcript

agent-transcript

github.com/openclawエージェントワークフロー393.3k325 回インストール今日更新
リポジトリ

agent-transcript について

agent-transcriptは、明示的に依頼されたプレビューや公開に向けて、エージェントのセッション記録を検索・整理するスキルです。ローカルログを検索し、無関係な内容や機密情報を除外してから共有する手順を定めています。

主な機能

  1. 01ローカルのCodex、Claude、Pi、OpenClawログを検索
  2. 02選択したセッションをMarkdownに変換
  3. 03タスクに関係する内容に絞り込み
  4. 04共有前に機密情報を確認

活用シーン

  1. 01PRやブランチに関係するセッションログの検索
  2. 02依頼されたプレビュー用記録の準備
  3. 03公開許可前の記録内容の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/openclaw/openclaw --skill agent-transcript

インストール後、Claude Code で/agent-transcriptを入力して読み込まれたか確認します。

同梱ファイルscripts/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 を指定すると、ローカルでの検索範囲が広がります。一致したログは候補として扱い、対象範囲を示す証拠とはみなさないでください。

レンダリングした Markdown は、表示、プレビュー、挿入の前に必ず自動で短縮してください。タスクに関係するユーザープロンプト、明確な判断、簡潔なツールの要約、検証結果だけを残してください。PR／issue の目的、ブランチ、変更ファイルを参考にして、無関係な前後のやり取りを削除してください。システム／開発者プロンプト、推論、生のツール出力、環境データ、ローカルパス、認証情報、ブラウザー／セッション／Cookie の詳細、認証 URL は削除してください。短縮後の内容を確認してください。ヘルパーによる編集だけでは、開示内容の確認として不十分です。機密情報が未解決のまま残っている場合は、記録を省略してください。

プレビューと挿入

プレビューを要求された場合は、短縮した Markdown を表示してください。HTML が要求された場合は、その短縮済みの内容からローカルプレビューを作成してください。ヘルパーの preview、html、append-body モードはセッションを再度レンダリングします。編集済みの Markdown ファイルを読み込むわけではなく、削除したやり取りを再び含めてしまう可能性があります。短縮されていない出力を、承認済みの成果物として使用しないでください。

ユーザーの許可が、記録を指定された PR／issue に公開することを明確に含む場合に限り、確認済みで対象を絞ったテキストだけを挿入してください。記録の生成やプレビューは、通常の PR 作成や編集がすでに承認されている場合でも、公開の許可にはなりません。その範囲の許可がない場合は、短縮した内容を表示し、挿入の前に公開許可を得てください。記録の公開を対象とする明示的な許可がすでにある場合、確認を繰り返す必要はありません。折りたたまれた <details> セクションを維持し、既存の記録マーカーを重複させずに置き換えてください。安全な該当箇所がない場合は、記録やプレースホルダーを追加せずに PR 作業を続けてください。明示的に要求された記録を含められない場合は、その旨を説明してください。記録の追加をレビュー上の優先要件にしないでください。

コメント

Markdown 対応