mcpField
V
visual-recap

visual-recap

github.com/kentcdodds開発57263 回インストール今日更新
リポジトリ

visual-recap について

visual-recapは、GitHubのプルリクエストにマーカーで囲まれた要約を追加するエージェントスキルです。差分から変更を分類し、リスクに応じた検証やプリミティブマップの更新を案内します。

主な機能

  1. 01Git差分に基づく変更の分類
  2. 02マーカー付きPR要約ブロックの追加・置換
  3. 03変更リスクに応じた検証手順
  4. 04プリミティブマップの確認と更新

活用シーン

  1. 01重要なプルリクエストの要約
  2. 02PR作成前の計画の記録
  3. 03プリミティブを追加・変更する作業の検証

インストール

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

$npx skills add https://github.com/kentcdodds/kcd-skills --skill visual-recap

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

同梱ファイル

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

references/
block-format.md
scripts/
check-primitives-map.mjs
classify-primitives.mjs
primitives-map.mjs
upsert-recap-block.mjs

詳細

システムの要約

変更が重要な場合（計画、PR の作成または更新、視覚的な要約の依頼）は、PR の説明にマーカーで囲んだブロックを 1 つ記載してください。GitHub がレンダリングします。このブロックは差分を読むことの代わりにはなりません。

実行タイミング

要約モードでは、記憶ではなく差分を読み取ります。 変更内容に関する主張は、git diff <base>...HEAD（および --stat）で確認できる必要があります。セッションのコンテキストで説明できるのは意図のみです。

分類器を実行してください。優先順位の高い順に adds、extends、composes へまとめます。composes と extends のどちらにするかは、引き続き差分に基づいて判断してください。adds は新しいマップエントリーです。

まとめ区分リスク追加事項
composes低配線と呼び出し箇所のみです。
extends中プロジェクトの制御 CLI を使い、シードユーザーとしてローカルで検証してください。ローカルで検証できない場合に限り、PR プレビューを使用します。
adds高primitives.yaml を更新し、check-primitives-map.mjs を実行して、同じローカル検証を行ってください（必要な場合はプレビューを使用します）。

この PR でプリミティブを追加、削除、または実質的に再構成する場合（新しい id、意味の変更、または変更が必要なオーナーシップルート）は、primitives.yaml を更新してください。通常の機能作業では summary を編集しないでください。どのリスクの場合も、該当するマップ内の不変条件に触れたことを明記してください。

PR 作成前の計画モードでは、**Mode:** plan を使用します。要約モードでは、そのブロックを git diff <base>...HEAD に基づいて置き換えます。計画モードでは、どのプリミティブにも変更が不要である場合、そのことを明示してください。これは最もリスクの低い結果です。

ブロックの形式例は、こちらを参照してください。 references/block-format.md。

コマンド

node .agents/skills/visual-recap/scripts/classify-primitives.mjs --base <base> --head HEAD --json
node .agents/skills/visual-recap/scripts/upsert-recap-block.mjs <pr-number> <block-file>
node .agents/skills/visual-recap/scripts/check-primitives-map.mjs

upsert スクリプトは mermaid をチェックしてから、マーカーブロックを置き換えるか、末尾に追加します。マーカーの外側にあるテキストは編集しません。重要なプッシュの後は、両方のコマンドを再実行してください。

失敗時

  • mermaid チェックがゼロ以外の値で終了します。図を修正してください。シーケンスの注記やメッセージに ; を入れないでください。
  • ブロックファイルは で始まり、 で終わる必要があります。
  • gh pr edit が Resource not accessible by integration (updatePullRequest) で失敗します。スクリプトはマージ済みの本文を引き続き出力します。その本文を Cursor ManagePullRequest で適用してください。Kody に PR を編集させないでください。
  • ヘルスチェックやログインのスモークテストは、中リスクまたは高リスクの検証にはなりません。ローカルの制御 CLI による証拠を優先し、ローカルで変更を検証できない場合に限りプレビューを使用してください。セッション Cookie を curl や Python に出力しないでください。

コメント

Markdown 対応