Claude Codeでテキストを整形・変換する

テキスト整形は、ルールが明確な変換ほど自動化しやすい領域です。文字コード、改行、CSVの列、Markdownの表などは、入力と期待する出力を固定して小さく試します。

依頼の型

入力・変換ルール・出力の対応を固定します。

1. 1入力と例外対象ファイル、コード・URLなど変えない範囲を決める。
2. 2別名で変換まず一つだけ処理し、元のファイルを残す。
3. 3形式に合う検査CSVは列と件数、JSONは構文と型、Markdownは構造を確認。

見た目だけでなく、件数と形式も確かめます。問題があればルールを直し、同じ一件で試し直します。

input.mdの連続空行を最大1行にし、コードブロック内は変更しない。
全角数字を半角へ変換するが、URL・日本語の引用符・表の区切りは保持。
変更件数と、変更前後の代表5行を出して。ファイルは上書きしない。

CSVからJSONへ変換するなら、列名、欠損値、重複行、文字コード、日付の形式を先に指定します。複数ファイルを扱うときは対象一覧を確定し、最初の1ファイルで結果を確認してから一括処理します。Claude Codeは読み書きとコマンド実行が可能なので、ドライランと保存先を指示します。 概要

検査

変換後に行数、列数、見出し、URL、括弧の対応、JSONの構文を確認します。日本語では句読点の置換がコードや引用文を壊すことがあるため、対象範囲を本文だけに限定します。JSONなら利用側のスキーマ検証、CSVならExcel等での文字化け確認も行います。空白を消す作業では、段落境界とコードブロックを保つことを最優先にします。

CLIの実行結果をJSON形式で受け取りたい場合は、現行CLIの claude -p と --output-format json が使えます。 CLIリファレンス これは本文の改行を消す指定ではありません。成功判定は終了コードだけでなく、生成ファイルの内容を検査します。

フォルダーの一覧整理はフォルダー整理、IDEで差分を確認するならVS Code拡張、記事へ応用するなら下書き作成へ進みます。

限界

曖昧な「読みやすくして」は文意を変えます。個人情報・契約文・コード・ログはバックアップを取り、変換ルールと除外条件を明示してから処理します。

変換の受け入れ条件は入力形式ごとに違います。Markdownなら見出し階層、リンク、コードブロック、表を比較し、CSVなら列名、行数、空欄、引用符、文字コードを比較します。JSONならパーサーで読み、必要なキーと型を確認します。代表行だけを目視するのではなく、件数と構文を機械的に確かめ、例外行は別ファイルへ退避します。