k lew

情報を失わないMarkdown改善

Markdown文書を、注意が散りやすい人でも読み進めやすい形に変えます。結論を先に置き、段落を分け、文を短くし、行動を明確にして、ノイズを取り除きます。 一般的な「レイアウトを整えて」とは異なる点が3つあります。 第一に、変更範囲をコントロールできます。書式だけを変更して本文の言葉は一語も変えず、マークアップや空白、ブロックの順序だけを組み替えることもできます。逆に、文体だけを変えてレイアウトには触れないことも可能です。指定がなければ、両方を変更します。規約やAPIドキュメントのように変更を抑えたい文書には軽微な変更モードを、議事録や乱雑なメモには再構成モードを使えます。 第二に、情報を決して削除しません。モデルに「簡潔にして」と頼んだときによくあるのは、制約条件を2文ほどひそかに削られても、すぐには気づけないことです。このスキルの鉄則は、並べ替えるだけで削除しないこと。長すぎる場合は折りたたむか付録に移し、変更後には「意図的に変更しなかったこと」も一覧にして、照合できるようにします。 第三に、AIらしい文体も取り除きます。大げさな言い回し、予告調のコロン、深そうに見せる表現、専門用語、根拠のない数量表現、数字のない主張、従属節の連続。これらは単なる文体の問題ではなく、それぞれ読者に余分な注意力を使わせます。しかも、モデルが内容を書き換えるときこそ、こうした表現が生まれやすくなります。 元のプロジェクトは、複数の agent で使える汎用 skill で、スコアリングと情報を損なわない検証を行う決定論的なスクリプト層を備えています（Claude Code、Codex、Grok Build、Gemini CLI、Cursor、opencode にインストールできます）。youmind 上のこの版はプロンプトのみのバージョンで、ルールは内蔵されていますが、スクリプトによる検証はありません。そのため、変更後は原文と照らし合わせて、数字と例外条件をもう一度確認してください。 ソースコードとルール集：github.com/tsonglew/adhd-md