/compact-docs

タスク: ドキュメントの圧縮と最適化

入力

$ARGUMENTS - 圧縮対象のマークダウンファイルのパス

処理フロー

1. 対象ドキュメントの読み込みと分析

   • 全体構造とコンテンツを把握
   • セクション間の関係性を理解

2. 圧縮テクニックの適用

   A. 重複情報の削減

   • セクション間で繰り返される内容を特定
   • 重複を相互参照に変換（例: 「詳細はXセクションを参照」）
   • 同じ概念の異なる表現を統一

   B. 冗長な説明の簡潔化

   • 長文を箇条書きに変換
   • 過度な詳細を要約し、重要な情報は保持
   • 情報の意味を損なわず情報密度を向上
   • 詳細な説明よりも簡潔で明確な表現を優先

   C. 矛盾の検出

   • セクション間の不整合を特定
   • 矛盾する記述や情報を報告
   • 内容の不整合を指摘（自動修正はしない）

   D. 経緯情報の削除

   • 変更履歴や更新日時の記述を削除
   • 「〜を追加しました」「〜に変更しました」などの履歴的記述を削除
   • gitで経緯を追えるため、ドキュメント内に履歴情報は不要

3. 圧縮レポートの生成 以下を含める:

   • 適用した圧縮技術と具体例
   • 圧縮前後の行数と削減率
   • 検出された矛盾（あれば）
   • 推奨される次のアクション（必要に応じて）

ガイドライン

• 意味を保持 - 簡潔さのために情報品質を犠牲にしない
• 構造を維持 - 元のドキュメントの構成を保つ
• 明示的に - 何を変更したか、なぜ変更したかを示す
• 矛盾は自動修正しない - 手動レビューのために報告する

出力形式

まず圧縮レポートを表示し、その後ファイルに編集を適用する。