更新情報の書き方：何を直したかを一行で伝える

読者は更新文に何を探しているか

更新文を開く人は、おおよそ次の二つの問いを持っています。

• 自分が前に遊んだときと、何が違うのか。
• その違いは、自分の遊び方に関わるのか。

この二つに答えるには、「何を」「どう変えたか」を具体的な名詞で書く必要があります。「改善」「調整」「最適化」は作者にとっては便利な言葉ですが、読み手の問いには答えません。どの部分がどちらへ動いたのかが、一語も入っていないからです。

もう一つ見落としやすいのが、読み手の立場の違いです。保護者は「子どもが遊ぶとき、困る点が減るのか」を知りたいでしょう。学習者は「やさしい段階があるのか」を知りたいでしょう。制作者は「どう作っているのか」が気になります。一行で全員に答えるのは難しいので、まず最も影響の大きい読み手を一人決め、その人の問いに答える一行を先頭に置きます。

v1.1で言えること、言えないこと

「v1.1で各作品に難易度・ヒント・記録などを拡張」というのが、確認できている範囲のすべてです。ここから言えるのは、拡張の方向性だけです。個別の機能がv1.1で初めて入ったのか、それ以前からあったのかは、この情報では断定できません。

この線引きは、更新文を書くときにそのまま使えます。

• 言えること：現在の作品にこの機能がある、という事実。
• 言えないこと：「このバージョンで追加した」という経緯。差分を見ずに書くと、実際と食い違うおそれがあります。

自分の作品の更新文を書くなら、前の版と今の版を並べて、実際に変わった箇所だけを拾います。記憶で書くと、直したつもりの箇所や、ついでに手を入れた箇所が混ざります。

公式作品の個別の仕様は、更新文の素材として十分です。たとえば次のような事実が確認できています。

• 潮目のオセロ：ひとり対局に3段階の相手、返る石のプレビュー、理由付きヒント、一手戻すがあります。ヒントと一手戻すはひとり対局のみです。
• かたちのあいだ：次の一手のヒントは最短とは限りません。一手戻しても手数は減りません。
• 月夜の配達：各夜の最少区間数はプレイ中だけ記録されます。
• 余白の庭：保存があり、以前の庭を引き継げます。

これらを「一行」にまとめる練習が、次の節です。

一行にする型：何が・どうなった・誰に関係するか

一行に入れる要素は三つです。

1. 何が（機能や画面の名前）
2. どうなった（できるようになった、見えるようになった、など）
3. 誰に関係するか、または条件

練習用に、ありがちな書き方と、型に沿った一行を並べます。右列は書き方の例であり、実際の更新文ではありません。

• ヒント機能を改善しました、読み手に残る疑問：どう良くなったのか、型に沿った一行（練習用）：ヒントに「なぜその手か」の理由が付きます（ひとり対局のみ）
• 操作性を向上させました、読み手に残る疑問：どの操作か、型に沿った一行（練習用）：矢印キーとEnterで石を置けます
• 記録機能を追加しました、読み手に残る疑問：残るのか、消えるのか、型に沿った一行（練習用）：各夜の最少区間数を記録します。記録は画面を開いている間だけ残ります
• 難易度を調整しました、読み手に残る疑問：易しくなったのか、難しくなったのか、型に沿った一行（練習用）：相手が3段階から選べます

どの行も、書き出しの名詞が具体的です。「ヒント」「矢印キーとEnter」「各夜の最少区間数」「相手」と、画面で探せる言葉になっています。読み手が作品を開いて「ここのことだ」と確認できることが、一行の条件です。

一行に収まらない場合は、無理に詰め込まず、一行目に最も大きい変更を置き、残りは箇条書きで続けます。一行目だけを読んで離れた人にも、変更の核が伝わる並びにしておきます。

できないことも一行に入れる

更新文の失敗で多いのは、書き足りないことよりも、読み手に過大な期待を持たせることです。「ヒントを追加しました」とだけ書くと、読み手は「詰まったら必ず最短の答えが出る」と受け取るかもしれません。

確認済みの仕様には、期待を調整する条件がいくつもあります。

• かたちのあいだのヒントは、最短とは限りません。「次の一手のヒント」と書くなら、「最短手とは限りません」まで入れるのが誠実です。
• かたちのあいだの「一手戻す」は、手数を減らしません。手数の少なさを競う人は、戻した場合の扱いを気にします。
• 潮目のオセロのヒントと一手戻すは、ひとり対局だけです。友達とのオンライン対局では使えません。
• 月夜の配達の最少区間数の記録は、プレイ中だけです。次に開いたときに残っていると思われると、がっかりさせます。

保存の有無は特に重要です。保存があるのは余白の庭、WAVE / WAVE、かたちのあいだの3作品で、他の10作品の記録や録音は画面を開いている間だけです。「記録を追加しました」の後ろに、残る期間を一言添えるだけで、読み手の期待が現実に合います。

判断基準は単純です。その機能を知って最初に思い浮かぶ誤解を一つ想像し、それを打ち消す語句を一行に入れます。入りきらなければ、二行目に回します。

自分の更新文を、読み手で確かめる手順

一行が伝わるかどうかは、書いた本人には判断できません。次の手順で、自分で確かめられます。結果はやってみるまで分かりません。ここでは設計だけを示します。

準備するもの

• 更新文の案を2〜3本（たとえば「ありがちな書き方」「型に沿った一行」「型に沿った一行に制限を足したもの」）
• 読み手を案の本数以上の人数分。更新対象の作品を遊んだ人と、遊んでいない人が混ざっていると、差が見えやすくなります。
• 時計（15秒を測るため）

手順

1. 一人の読み手には、案を一つだけ見せます。同じ人に複数の案を見せると、前の案が判断に影響します。
2. 15秒だけ見せて隠します。
3. 「何が変わったと思いますか」「自分に関係があると思いますか」「その機能で、できないことはありそうですか」の三つを、口頭か手元のメモで答えてもらいます。
4. 答えを一字一句メモします。作者が言い換えて記録しないようにします。

記録の取り方

案ごとに、次の三点を数えます。

• 変更内容を、実際の変更と同じ意味で言い直せた人数
• 「自分に関係がある」「ない」と答えた人数と、その理由
• 実際にはできないことを「できる」と答えた人数（誤解の数）

結果の読み方

• 言い直しが人によってばらばらなら、一行の中の名詞が曖昧です。画面に出る言葉に置き換えます。
• 「関係があるか」の答えが、狙った読み手と食い違うなら、誰に関係するかの条件が足りません。
• 誤解が出たなら、その誤解を打ち消す語句を、一行か二行目に足します。

起こりやすい誤り

• 書いた本人に読んでもらう。内容を知っているため、曖昧さに気づけません。
• 読み手の人数が少ないのに、傾向を断定する。数人の答えは、方向を探る材料にとどめます。
• 15秒を超えて読ませる。実際の読まれ方に近づけるため、時間は守ります。

次の行動

自分の作品の直近の更新を一つ選び、前の版と今の版を並べて、変わった箇所を名詞で書き出してください。それを「何が・どうなった・誰に関係するか」の三要素で一行にし、見落とされやすい制限を一語足します。次に、上の手順で2案を別々の読み手に15秒だけ見せ、言い直しが一致するかを見てください。

アソバースでは公開内容の更新ができ、投稿画面の「紹介文と遊び方を作成」では選択言語の下書きが作られ、「この文章を使う」を押したときだけ反映されます。更新履歴を専用に載せる欄や、更新を通知する機能があるかどうかは、確認済みの案内にありません。使う前に、現在の案内で確認してください。