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

2.0 KiB
Raw Blame History

description, allowed-tools
description allowed-tools
ドキュメントの冗長性を削減し、明瞭性を向上させる圧縮コマンド Read, Edit

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

入力

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

処理フロー

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

    • 全体構造とコンテンツを把握
    • セクション間の関係性を理解
  2. 圧縮テクニックの適用

    A. 重複情報の削減

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

    B. 冗長な説明の簡潔化

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

    C. 矛盾の検出

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

    D. 経緯情報の削除

    • 変更履歴や更新日時の記述を削除
    • 「〜を追加しました」「〜に変更しました」などの履歴的記述を削除
    • gitで経緯を追えるため、ドキュメント内に履歴情報は不要
  3. 圧縮レポートの生成 以下を含める:

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

ガイドライン

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

出力形式

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