Initial commit

commands/compact-docs.md

@@ -0,0 +1,56 @@
+---
+description: ドキュメントの冗長性を削減し、明瞭性を向上させる圧縮コマンド
+allowed-tools: Read, Edit
+---
+
+## タスク: ドキュメントの圧縮と最適化
+
+### 入力
+`$ARGUMENTS` - 圧縮対象のマークダウンファイルのパス
+
+### 処理フロー
+
+1. **対象ドキュメントの読み込みと分析**
+   - 全体構造とコンテンツを把握
+   - セクション間の関係性を理解
+
+2. **圧縮テクニックの適用**
+
+   **A. 重複情報の削減**
+   - セクション間で繰り返される内容を特定
+   - 重複を相互参照に変換（例: 「詳細はXセクションを参照」）
+   - 同じ概念の異なる表現を統一
+
+   **B. 冗長な説明の簡潔化**
+   - 長文を箇条書きに変換
+   - 過度な詳細を要約し、重要な情報は保持
+   - 情報の意味を損なわず情報密度を向上
+   - 詳細な説明よりも簡潔で明確な表現を優先
+
+   **C. 矛盾の検出**
+   - セクション間の不整合を特定
+   - 矛盾する記述や情報を報告
+   - 内容の不整合を指摘（自動修正はしない）
+
+   **D. 経緯情報の削除**
+   - 変更履歴や更新日時の記述を削除
+   - 「〜を追加しました」「〜に変更しました」などの履歴的記述を削除
+   - gitで経緯を追えるため、ドキュメント内に履歴情報は不要
+
+3. **圧縮レポートの生成**
+   以下を含める:
+   - 適用した圧縮技術と具体例
+   - 圧縮前後の行数と削減率
+   - 検出された矛盾（あれば）
+   - 推奨される次のアクション（必要に応じて）
+
+### ガイドライン
+
+- **意味を保持** - 簡潔さのために情報品質を犠牲にしない
+- **構造を維持** - 元のドキュメントの構成を保つ
+- **明示的に** - 何を変更したか、なぜ変更したかを示す
+- **矛盾は自動修正しない** - 手動レビューのために報告する
+
+### 出力形式
+
+まず圧縮レポートを表示し、その後ファイルに編集を適用する。