Prompt Diff は単純な行単位の diff ではなく、LLM システム Prompt およびエージェント指示に対する豊富な動作的およびセマンティックな変更ログを提供します。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install phy-prompt-diff
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って phy-prompt-diff をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
Prompt Diff とは？
Prompt Diff は、従来のバージョン管理と AI Prompt エンジニアリングの溝を埋めるために設計された専門的なローカル開発者ツールです。標準的なコード diff ツールは文字や行の変更を追跡しますが、このツールは Prompt を動作仕様として処理します。テキストをセマンティックに完全な指示単位に分解し、修正がエージェントの動作、ペルソナの整合性、およびタスク処理の制約にどのように影響するかをチームが理解するのを助けます。
Openclaw Skills を活用することで、Prompt Diff は外部 API への依存をゼロにし、完全なデータプライバシーを保証します。開発者は、強化または緩和されたルール、安全指標の低下、そして SKILL.md や AGENTS.md といったシステムファイルの反復プロセスにおける継続的な整合性を確保するための構造的な更新を強調した、具体的でコピー＆ペースト可能なコミットログを受け取ります。
Prompt Diff のユースケース
主なユースケース
- Prompt アップグレード監査: 新しいシステム Prompt を本番環境のエージェントに展開する前に、動作および安全性の変更を評価します。
- AI の矛盾防止: モデルのパフォーマンスを低下させる競合的または矛盾するステートメントを特定するために、変更された Prompt をスキャンします。
- Guardrail とセキュリティコンプライアンス: 禁止事項の誤削除や意図しない権限の拡大を捕捉します。
- 自動コミット追跡: バージョン管理の Pull Request とともに、人間が読める詳細な動作変更ログを生成します。
- リファクタリングの最適化: 命令密度の変化と token 数の削減を測定し、アンカー例がそのまま維持されていることを確認します。
Prompt Diff の仕組み
論理アーキテクチャとワークフロー
- 入力パース: ユーザーはファイルパス、Git リビジョンマーカー、貼り付けられたフラグメント、または履歴追跡コマンドを通じてターゲット資産を提供します。
- 指示の分離: コンテキストの書式設定の手掛かり、箇条書き、リスト項目、および命令動詞に基づいて、Prompt テキストを個別の指示単位に分割します。
- セマンティック状態分類: 各追跡単位は、ADDED、REMOVED、SOFTENED、HARDENED、EXPANDED、または NARROWED といった特定の動作デルタインデックスの下で分析および分類されます。
- リスクと安全評価: このツールは、削除された Guardrail、プロファイルまたは役割の変異、構造的なトーンの変化を発見するために、高優先度のスキャンループを自動的にトリガーします。
- 矛盾検証: 論理的な衝突や競合するガイドラインを見つけるために、更新されたバージョン全体でローカル検証サイクルが実行されます。
- 変更ログのコンパイル: 出力レポートは、構造化された分析テーブル、詳細な脆弱性のハイライト、およびクリーンな Markdown 形式の Git コミットテンプレートを生成します。
Prompt Diff のセットアップ
設定とインストール
Prompt のライフサイクル評価を開始するには、ローカル Shell から直接トリガーインターフェースを実行してください：
# 2つの明示的なファイルバージョン間の変更を分析
/prompt-diff AGENTS-v4.md AGENTS-v5.md
# 現在のローカルワークスペースと以前の Git コミット履歴を比較
/prompt-diff SKILL.md
# セキュリティ変数に完全に焦点を当てた専門的な評価を要求
/prompt-diff --focus security AGENTS-v4.md AGENTS-v5.md
Prompt Diff のデータスキーマとタクソノミー
セマンティック指標と構造スキーマ
指示の分類
| 分類 | 基準 | 機能的影響 |
|---|---|---|
| ADDED | ターゲットバージョンには存在するが、元のソースにはまったくない項目 | 完全に新しいエージェント操作の導入 |
| REMOVED | 元のソースには存在するが、ターゲットバージョンにはまったくない項目 | 明示的な制約または動作機能の削除 |
| SOFTENED | 命令的な指示がオプションの好みに弱められた | ルールの厳格性とモデルの予測可能性の低下 |
| HARDENED | 許容的なステートメントが新しい制限を組み込むように修正された | タスク実行境界の強化 |
評価の重大度マトリックス
- CRITICAL: 安全パラメータが削除された（例：API Key を保護する制約の剥離）場合や、アクセス層が拡大された場合にフラグが立てられます。
- HIGH: 論理検証の失敗時にトリガーされます（例：エージェントに対して、簡潔であると同時に詳細であるよう指示するなど）。
- MEDIUM: 操作ルールの顕著な変更、トーン密度の低下、または基礎となるコンテキスト例が削除された場合にインスタンス化されます。
- LOW / INFO: 細かな表現の更新、セクションの移動、および標準的な token ボリュームの変動時に登録されます。
Prompt Diff の高度な機能
高度な最適化制御
- ターゲットフォーカスモード:
--focus security、--focus tone、--focus contradictions、または--focus examplesといったフラグを使用して、特定のトピックを精査するために処理パイプラインをフィルタリングします。 - ローカル実行エンジン: 分析は完全に決定論的なローカルパース戦略に依存し、プライベートな企業用 Prompt が外部 API と共有されないことを保証します。
- コミット前のクイックチェック: 高速なローカル開発サイクル中に即時の概要指標を得るために、迅速な検証監査（
--quick）を実行します。 - 自動コミットフォーマット: すぐに使える Markdown テンプレートは公式の業界バージョンログと一致しており、破壊的な変更、追加された機能、および未解決の安全上の問題を文書化します。
SKILL.md
ローディング
関連するOpenclawのスキル
Pipeline Contract Enforcer
スキーマの検証とパイプラインステージ間のドリフト検出により、サイレントなパイプライン障害を防ぐ、ローカルの、エージェントネイティブなデータ契約執行ツールです。
Dotenv Inheritance Mapper
フレームワークの複雑な .env ファイルの上書き階層を解決し、構成リスクをフラグ立てし、ソースコードの使用状況とクロスリファレンスするローカル環境変数分析スキルです。
OpenAPI Mock Server
バックエンドコードを書くことなく、OpenAPI 3.x または Swagger 2.0 の仕様ファイルや URL からローカル HTTP Mock Server を即座に実行します。
TypeScript Any Auditor
ローカルかつ依存関係ゼロの型カバレッジ強制ツールであり、暗黙的および明示的な any のリークを排除する TypeScript 厳格モード監査ツールです。
Error Writer
Error Writerは、誤ったエラーメッセージや例外文字列を、エンドユーザー、API、システムログに最適な、明確でアクション可能なバリエーションに自動的に書き換えます。
Flag Janitor
Flag Janitorは、ローカル環境で動作するプライバシー優先の技術的負債分析ツールです。陳腐化、ハードコード、または未定義のfeature flagを検出し、それをクリーンアップするための正確なリファクタリング計画を生成します。
特徴*
