humanizer

Humanizer

文字を正規化し、多用されている表現にフラグを付け、文脈に応じた文章作成ガイドラインに従って、AI が生成したテキストを整えます。

ワークフロー

1. 文脈を特定する — README、メール、Slack メッセージ、コミットメッセージ、一般的なドキュメントのどれを書くのかを判断します
2. ガイドを読み込む — 適切なリファレンスファイルを読みます（下の表を参照）
3. ガイドに沿って書く — 下書きの段階で、トーン、構成、長さに関するガイドラインを適用します
4. スクリプトを実行する — 最終テキストを humanize にパイプで渡し、機械的な修正と表現へのフラグ付けを行います
5. フラグを確認する — フラグが付いた表現は自然な言い回しに書き換えます。削除するだけではなく、平易な表現に置き換えてください

文脈別ガイド

文脈	リファレンス	主な原則
README	references/readme-guide.md	直接的かつ事実に即して書き、最初にコマンドを示す
メール	references/email-guide.md	最初の文で依頼内容を伝える
Slack	references/slack-guide.md	簡潔に — 最大1〜2文
コミット	references/commit-guide.md	命令形を使い、何をしたかではなく、なぜ行ったかを説明する
一般	すべてのガイドから常識的に判断する	堅苦しさより明瞭さを優先する

CLI リファレンス

コマンド	説明
echo "text" | humanize	標準入力からテキストを読み込んで整える
humanize file.md	ファイルからテキストを読み込んで整える
humanize --report file.md	置換回数を含む詳細な出力
humanize --help	使い方を表示

終了コード： 0 = 問題なし、1 = エラー、2 = 表現にフラグあり（テキストは整形済み）

スクリプトが自動で修正する内容

• 全角ダッシュ → 半角ハイフンとスペース
• スマート引用符 → 半角の引用符
• Unicode の省略記号 → ピリオド3つ
• ノーブレークスペース／不可視スペース → 通常のスペース
• 不可視の Unicode ウォーターマーク文字 → 削除
• 箇条書き記号 → ASCII ハイフン

フラグが付く内容（自動修正はされません）

スクリプトは、人の判断による書き換えが必要な表現にフラグを付けます。

• 要注意の単語： delve、tapestry、seamless、robust、comprehensive など
• 曖昧な表現の埋め草： 「重要なのは」「注目すべきなのは」
• 使い古された書き出し／結び： 「お元気でお過ごしのことと思います」「お気軽にお問い合わせください」
• 多用されているつなぎ言葉： furthermore、moreover、additionally

パターンの全一覧：references/phrases.txt