Repolode
tanishqkancharla

tanishqkancharla/diffmap

コーディングエージェントに、コード変更を各要素からソースへリンクしたインタラクティブな図で説明させるエージェントスキル。

スター
238
フォーク
9
未解決の Issue
1
最終コミット
昨日

これは何?

diffmapは、コーディングエージェントが書いたコードのレビューを支援します。エージェントは、インタラクティブなMermaid図や、ステップごとに確認できるアニメーション付きサービス図、図やコールスタックの差分を含むMarkdown形式の仕様書を作成します。図の各要素は、関連するファイル、シンボル、コミットにリンクしているため、レビュー担当者は図中のボックスや行から、その背後にあるコードへ移動できます。

仕様書はnpxで起動するローカルビューアで表示できます。ビューアにはDiffパネル、エージェントに渡すMarkdownリストとしてコピーできるインラインコメント、レビューするファイルを順番に示すコミットカードのサポートも含まれています。仕様書は限定公開のGitHub gistとして共有し、diffmap.devで開くこともできます。このプロジェクトは、独自のMarkdown形式を解析するライブラリAPIを備えたTypeScriptパッケージです。

主な機能

  • 01エージェントが作成した仕様書から、インタラクティブなMermaid図やアニメーション付きサービス図を生成する。
  • 02図やコールスタックの差分を表示し、現行版または提案版にのみ存在する要素を示す。
  • 03図のノード、コールスタックの行、本文中の参照を、ソースファイル、シンボル、コミットにリンクする。
  • 04Diffパネルと、エージェントに渡すためにコピーできるインラインコメントを備えたローカルビューアを提供する。
  • 05仕様書を限定公開のGitHub gistとして共有し、diffmap.devで閲覧できるようにする。

ユースケース

  • コーディングエージェントが作成した大規模な変更を、マージ前にレビューする。
  • 機能ブランチのリクエストフローや状態変化をチームメイトに説明する。
  • エージェントの差分に行単位のコメントを付け、番号付きリストとして返す。
  • プルリクエストのレビュー用説明をリンクでチームに共有する。

クイックスタート

  1. 1

    変更のあるリポジトリで、diffmapのプロンプトをエージェントに貼り付けて試してください

  2. 2

    generate-diffmapスキルをインストールします

    npx skills add tanishqkancharla/diffmap --skill generate-diffmap
  3. 3

    specファイルでローカルビューアーを実行します

    npx @tanishqkancharla/diffmap serve path/to/file.md

使う前に知っておきたいこと

  • specをリンクで共有する機能は実験段階で、gh CLIへのログインが必要です。
  • Gistでホストされるビューアーは、ブラウザーからapi.github.com経由でGistを取得します。

収録されている特集

トピック

よくある質問

diffmap とは?
コーディングエージェントに、コード変更を各要素からソースへリンクしたインタラクティブな図で説明させるエージェントスキル。 diffmapは、コーディングエージェントが書いたコードのレビューを支援します。エージェントは、インタラクティブなMermaid図や、ステップごとに確認できるアニメーション付きサービス図、図やコールスタックの差分を含むMarkdown形式の仕様書を作成します。図の各要素は、関連するファイル、シンボル、コミットにリンクしているため、レビュー担当者は図中のボックスや行から、その背後にあるコードへ移動できます。
diffmap は無料で使えますか?ライセンスは?
diffmap は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
diffmap は今もメンテナンスされていますか?
活発にメンテナンス中。diffmap の最終コミットは 2026年11月6日 です。
diffmap は何に使えますか?
コーディングエージェントが作成した大規模な変更を、マージ前にレビューする。 機能ブランチのリクエストフローや状態変化をチームメイトに説明する。 エージェントの差分に行単位のコメントを付け、番号付きリストとして返す。 プルリクエストのレビュー用説明をリンクでチームに共有する。
diffmap のインストール方法は?
変更のあるリポジトリで、diffmapのプロンプトをエージェントに貼り付けて試してください generate-diffmapスキルをインストールします: npx skills add tanishqkancharla/diffmap --skill generate-diffmap specファイルでローカルビューアーを実行します: npx @tanishqkancharla/diffmap serve path/to/file.md
diffmap はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/tanishqkancharla/diffmap

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト