Files
gh-mh4gf-shared-config-clau…/commands/compact-docs.md
2025-11-30 08:40:09 +08:00

57 lines
2.0 KiB
Markdown
Raw Blame History

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