mcpField
A
agent-transcript

agent-transcript

github.com/steipeteエージェントワークフロー7.5k97 回インストール1 週間前に更新
リポジトリ

agent-transcript について

ローカルの Codex、Claude、Pi、OpenClaw のログから、範囲を絞ったプレビューやトランスクリプトを作成するスキルです。無関係な内容を削り、機密情報を確認してから表示し、公開には明示的な許可を求めます。

主な機能

  1. 01ローカルのエージェントログ検索
  2. 02セッションの Markdown 化
  3. 03タスク範囲に沿った内容の整理
  4. 04出力に含まれる機密情報の確認
  5. 05公開前の許可確認

活用シーン

  1. 01依頼されたトランスクリプトのプレビュー作成
  2. 02プルリクエストに関係するログの選定
  3. 03無関係または機密性のある情報の削除
  4. 04承認済みトランスクリプトの PR や issue への挿入

インストール

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

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

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

同梱ファイルscripts/agent-transcript

詳細

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

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

ローカルで準備する

このヘルパーは、ローカルの Codex、Claude、Pi、OpenClaw のログを読み取ります。検出やレンダリングにネットワークは使用しません。未加工のログをアップロードしてはいけません。

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

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

find はデフォルトで最新の一致するログ 400 件をスキャンします。--max-files N を指定すると、ローカルでの検出範囲が広がります。一致した項目は候補として扱い、対象範囲の証拠とみなしてはいけません。

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

プレビューと挿入

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

ユーザーの許可が、名前を指定した PR／issue へのトランスクリプトの公開を明示的に対象としている場合に限り、確認・範囲設定済みのテキストだけを挿入してください。トランスクリプトを生成またはプレビューしても、公開の許可にはなりません。通常の PR 作成や編集がすでに承認されている場合も同様です。その範囲の許可がない場合は、整理済みの結果を表示し、挿入前に公開の許可を得てください。トランスクリプトの公開を対象とする明示的な許可がすでにある場合は、再確認は不要です。折りたたみ式の <details> セクションを維持し、既存のトランスクリプトマーカーは重複させず置き換えてください。安全な一致項目がない場合は、トランスクリプトもプレースホルダーも追加せず、PR 作業を続けてください。明示的にリクエストされたトランスクリプトを用意できない理由となる場合は、省略したことを説明してください。レビューの優先要件として、トランスクリプトの追加を推奨してはいけません。

コメント

Markdown 対応