Claude Codeで既存文章をリライトする

リライトでは「読みやすくする」と「新しい事実を加える」を分けます。前者は文章編集、後者は調査を伴う別工程です。差分を確認できる手順にすると、変更の理由と影響を追いやすくなります。

変更契約を先に書く

滑らかな文章に直す前に、変更の境界を決めます。

• 変えてよい表現重複、段落の順序、見出し、語尾。今回の目的に絞って直す。
• 保持する内容数値、固有名詞、URL、条件、結論。原文と照合する。

事実を更新する場合は別途根拠を調べます。採用前にold.mdとnew.mdを比較し、意味が変わっていないか確認します。

原文 old.md を読み、意味・数値・固有名詞・リンクを変えずに、
ですます調で25%短くして。変更箇所を「削除・言い換え・要確認」に分類し、
原文にない事実は追加しない。new.mdへの保存は提案後に行う。

短縮、丁寧化、見出しの整理は同じ文章を対象に一つずつ行います。展開したい場合は、追加したい根拠URLを渡し、「引用元に書かれた範囲だけ」と制限します。Claude Codeはファイル編集が可能なので、対象パスと上書き可否を依頼に含めます。 概要

差分を読む

出力後に次を確認します。

• 数字、日付、バージョン、コマンド、URLが保持されているか。
• 否定が肯定へ、条件付きの話が一般論へ変わっていないか。
• 体験談・推測・公式仕様の表現が混ざっていないか。
• 見出しを変えた結果、内部リンクや目次がずれていないか。

別名で保存した2ファイルを比べるには、Gitが使える端末で次を実行します。

git diff --no-index -- old.md new.md

--no-indexはディスク上の2ファイルを比較する指定です。通常のgit diff -- old.md new.mdは、それぞれのファイルの未ステージ変更を見る指定で、2ファイル同士の比較にはなりません。差があれば終了コード1になるため、このコマンドの1を実行失敗と取り違えないでください。Git公式の比較方法

公開記事は更新日と内容確認日を分け、確認していない箇所を「確認済み」と書きません。

文章の骨格は下書き、見出しの再設計は構成作り、記事一覧を整理する場合はカテゴリ整理へ進みます。

限界

リライト後の文章が自然でも事実が正しいとは限りません。仕様・料金・安全情報は公式資料へ戻り、追加調査と編集を分けて記録します。

変更履歴を残す

記事ごとに原文、依頼文、生成稿、採用稿、確認日を保存します。変更理由が「読みやすさ」だけなのか、資料の更新に伴う事実変更なのかを記録すると、次回の再確認範囲を絞れます。リンク先が消えた場合は、似たURLへ自動で置き換えず、代替根拠を調べてから編集します。

リライト前に、保持する要素と変更してよい要素を表にします。保持するものは数値、固有名詞、引用、URL、条件、結論です。変更してよいものは段落の順序、重複表現、見出し、語尾です。変更後に保持項目を機械的に検索し、見つからないものを人が確認します。これなら文章を滑らかにする作業と、内容を更新する調査を混ぜずに済みます。