hisaichi5518 https://blog.hatena.ne.jp/hisaichi5518/ パルカワ2 https://hisaichi5518.hatenablog.jp/ Claude Code に仕様書や PR の本文、レビューコメント*1を書かせているが、そのままだと読みにくいことがあった。そこで、日本語の文書を書く前に読み手を整理させる writing-japanese というスキルを作ったので、作った経緯と気をつけたことを書く。 困っていたこと Claude Code が書く日本語の文書には、次の 2 つの症状があった。 読む順序への配慮がない 用語を定義より先に使っていて、読み進めた先でやっと定義が出てくる 各章が「ほかの章も読んだ」前提で書かれている 読み手に要らない情報を書く 例えば、画面ごとの表示と操作を書いた仕様書(画面仕様書)に、バーコードの… 190 <iframe src="https://hatenablog-parts.com/embed?url=https%3A%2F%2Fhisaichi5518.hatenablog.jp%2Fentry%2F2026%2F10%2F24%2F160741" title="日本語の文書を書く前に読み手を整理させるスキルを作った - パルカワ2" class="embed-card embed-blogcard" scrolling="no" frameborder="0" style="display: block; width: 100%; height: 190px; max-width: 500px; margin: 10px 0px;"></iframe> Hatena Blog https://hatena.blog 2026-10-24 16:07:41 rich https://hisaichi5518.hatenablog.jp/entry/2026/10/24/160741 1.0 100%