mcpField
O
openclaw-agent-transcript

openclaw-agent-transcript

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

openclaw-agent-transcript について

PR 作業でエージェントのセッション記録を検索、レンダリング、確認し、必要に応じて共有するスキルです。ローカル処理と慎重な内容整理を重視し、公開には明示的な許可を求めます。

主な機能

  1. 01ローカルのエージェントログ検索
  2. 02セッションログの Markdown 化
  3. 03記録内容の整理と確認
  4. 04部分記録の通知を保持
  5. 05公開前の明示的な許可確認

活用シーン

  1. 01依頼されたセッション記録のプレビュー
  2. 02許可済み PR や issue 向け記録の準備
  3. 03合成ログを使った記録ツールの検証

インストール

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

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

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

LICENSE
MIRROR.md
package.json
scripts/
agent-transcript
agent-transcript.test.mjs

詳細

エージェントのトランスクリプト

ユーザーがトランスクリプトまたはプレビューを明示的に求めた場合にのみ使用します。デフォルトでは省略してください。通常の PR 作業中に、トランスクリプトを含めるかどうかを提案したり、尋ねたりしてはいけません。プレビューの依頼だけでは、公開の許可にはなりません。

*.openclaw.ai でホストされているセッションの場合、共有を求められたときはネイティブのセッション共有を使用してください。別個のトランスクリプトを書き出すのは、ユーザーがそのコピーを明示的に求めた場合に限ります。ホスティング先は、リポジトリの URL やデプロイ／テスト対象ではなく、現在のセッション URL から特定してください。別形式での書き出しを提案してはいけません。

ローカルでの準備

ファイルの検出とレンダリングでは、デフォルトでネットワーク呼び出しを行わず、ローカルの Codex、Claude、Pi、OpenClaw のログを読み取ります。生ログをアップロードしてはいけません。

skills/openclaw-agent-transcript/scripts/agent-transcript find \
  --query "$PR_TITLE $BRANCH_OR_PR_URL" --cwd "$PWD" --since-days 14
skills/openclaw-agent-transcript/scripts/agent-transcript render \
  --session "$SESSION_JSONL" --out /tmp/agent-transcript.md

.agents/skills 配下に同期するダウンストリームリポジトリでは、skills/openclaw-agent-transcript を .agents/skills/openclaw-agent-transcript に置き換えてください。

find はデフォルトで、条件に一致する最新のログを最大 400 件スキャンします。--max-files N を指定すると、ローカルでの検出範囲が広がります。一致したファイルは候補として扱い、対象範囲の証拠とみなしてはいけません。 find と html は、古いファイルも含め、すべてのルートにある JSONL ファイルを最大 20,000 件まで数え、それを超えると失敗します。--max-discovery-files N には正の整数を指定できます。上限を引き上げる前に、対象ルートを絞り込んでください。

ファイルのレンダリングでは、各セッションの先頭と末尾から最大 8 MiB を読み取り、最大 12,000 行を解析します。--max-read-bytes N でバイト数の上限を変更できます。トリミング、プレビュー、挿入の際も、表示される部分トランスクリプトの通知と sourceTruncated の統計情報を保持してください。省略したソースを完全なものとして説明してはいけません。これらはファイル読み取りの上限であり、別個の app-server レンダリングモードには適用されません。短いファイルシステム読み取りは再試行されます。予期しない EOF が発生した場合、不完全な入力を完全なセッションとして扱わず、レンダリングまたは検出を停止します。

レンダリングした Markdown は、表示、プレビュー、挿入の前に自動的にトリミングしてください。タスクに関連するユーザープロンプト、確認できる決定事項、簡潔なツールの要約、証拠の結果だけを残します。PR／issue の目的、ブランチ、変更ファイルを基準に、それ以前／以後の無関係なやり取りを削除してください。システム／開発者プロンプト、推論、生のツール出力、環境データ、ローカルパス、認証情報、ブラウザー／セッション／Cookie の詳細、認証 URL は削除してください。トリミング後の結果を確認してください。ヘルパーによる秘匿化だけでは、開示内容の確認として不十分です。機密情報が残っている場合は、トランスクリプトを省略してください。

プレビューと挿入

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

ユーザーの承認範囲に、指定された PR／issue へのトランスクリプトの公開が明確に含まれている場合に限り、確認済みで対象範囲を絞ったテキストを挿入します。トランスクリプトの生成やプレビューは、通常の PR 作成または編集がすでに承認されている場合でも、公開の許可にはなりません。その範囲の承認がない場合は、トリミングした結果を表示し、挿入前に公開の許可を得てください。トランスクリプトの公開を明示的に含む既存の承認がある場合、再確認は不要です。折りたたまれた <details> セクションを維持し、既存のトランスクリプトマーカーがあれば重複させずに置き換えてください。安全な一致箇所が見つからない場合は、トランスクリプトやプレースホルダーを追加せずに PR 作業を続けてください。明示的に求められたトランスクリプトを出せないことで依頼に応えられない場合は、省略したことを説明してください。トランスクリプトの掲載を、レビューで優先すべき要件として扱ってはいけません。

ヘルパーの変更を検証する

node --test skills/openclaw-agent-transcript/scripts/agent-transcript.test.mjs

ダウンストリームの .agents/skills コピーでは、テストの相対ヘルパーパスが解決されるよう、そのテストコマンドを .agents/ から実行してください。合成ログと分離された検出ルートを使用してください。このスキルの検証だけを目的に、実際のユーザーログを検出してはいけません。

コメント

Markdown 対応